addbib(1) addbib(1)NAME addbib - create or extend bibliographic database SYNOPSIS addbib [-p promptfile] [-a] database DESCRIPTION addbib initiates or furthers a bibliography, entered as a database. The database structure allows formatting to be imposed as a step separate from data entry; data entry must be performed only once. Database entries consist of keyletters and relevant fields. For example, %A is the keyletter for author-name, and Bill Tuthill (the author of refer) could fill in this field. (Further examples are given below.) Once entered, entries may be culled from the database easily and in the proper format. The refer program handles this compilation; you do not have to look up entries by hand. When this program starts up, answering y to the initial In- structions? prompt yields directions; typing n or RETURN skips them. addbib then prompts for various bibliographic fields, reads responses from the terminal, and sends output records to a database. A null response (just RETURN) means to leave out that field. A minus sign (-) means to go back to the previous field. A trailing backslash allows a field to be continued on the next line. The repeating Continue? prompt allows the user either to resume by typing y or RE- TURN, to quit the current session by typing n or q, or to edit the database with any system editor (vi, ex, edit, ed), by typing its name. The -a flag option suppresses prompting for an abstract; asking for an abstract is the default. Abstracts are ended with a CONTROL-D. The -p flag option causes addbib to use a new prompting skeleton, defined in promptfile. This file should contain prompt strings, a tab, and the keyletters to be written to the database. The most common keyletters and their meanings are given below. addbib insulates you from these keyletters, since it gives you prompts in English, but if you edit the bibliogra- phy file later on, you will need to know this information. %A Author's name %B Book containing article referenced %C City (place of publication) %D Date of publication %E Editor of book containing article referenced %F Footnote number or label (supplied by refer) %G Government order number %H Header commentary, printed before reference April, 1990 1
addbib(1) addbib(1)%I Issuer (publisher) %J Journal containing article %K Keywords to use in locating reference %L Label field used by -k option of refer %N Number within volume %O Other commentary, printed at end of reference %P Page number(s) %Q Corporate or Foreign Author (unreversed) %R Report, paper, or thesis (unpublished) %S Series title %T Title of article or book %V Volume number %X Abstract; used by roffbib, not by refer %Y ignored by refer %Z ignored by refer Except for A, each field should be given just once. Only relevant fields should be supplied. An example is: %A John Smith %T Using A/UX %I Apple Computer %C New York %D 1987 FILES /usr/ucb/addbib promptfile optional file to define prompting CAVEATS The length of the prompt strings in a user-defined prompt file should be less than or equal to 20 characters. That is, addbib will only display the first 20 characters. If the prompt string is longer than 20 characters, addbib will append the keyletter from the prompt file to the end of the truncated prompt string. SEE ALSO indxbib(1), lookbib(1), refer(1), roffbib(1), sortbib(1). 2 April, 1990