addbib(1) addbib(1)NAME addbib - creates or extends a bibliographic database SYNOPSIS addbib [-a] [-p prompt-file] database ARGUMENTS -a Suppresses the default prompting for an abstract. database Specifies the name of a file to be used to store the output of addbib. If the file specified by database does not exist, addbib creates it. If the file already exists, addbib appends to it any entries you made. -p prompt-file Causes addbib to use prompts that are defined in prompt-file. This file should contain lines that consist of a prompt string, a tab, a percent sign (%), and the option, in that order. DESCRIPTION addbib creates or extends a bibliographic database. The structure of the database allows formatting to be imposed as a separate step after the data is entered. Database entries consist of options and relevant fields. Once you have entered the data, you can use sortbib(1) and roffbib(1) to print the database in a standard bibliographic format. You can also embed keywords from the database in footnotes in nroff(1) or troff(1) documents and use refer(1) to extract the complete reference from the database in proper footnote format and print it in your document. When started, addbib displays the Instructions? prompt. Entering y causes addbib to print a summary of how to enter data. You can enter n or press RETURN to skip the summary. Next, addbib prompts for various bibliographic fields and reads the response from the terminal. The addbib command does not actually write the fields to the database until all the fields for one record have been prompted. If you have no data for a particular field, press RETURN to go on to the next prompt. To enter data, type the information and press RETURN. The only exception to this practice occurs when you enter data in response to the Abstract: prompt. In this case, type the data, press RETURN, and then press CONTROL-D. If you wish to enter no data in response to the Abstract: prompt, press CONTROL-D. To continue any field on the next line, enter a backslash (\). In response, addbib places a > prompt on the next line, where you can enter more data. When the field is January 1992 1
addbib(1) addbib(1)written to the database, the second and any additional continuation lines are separated by the newline character. You can enter a minus sign (-) to go back to a previous prompt and add a second field of a particular type. For example, you can use this feature to enter the name of each author of a multiple-author book. You cannot use this feature to overwrite a previously entered field. When addbib displays the Continue? prompt, which appears after you have entered one complete record, you can enter y or press RETURN to continue or enter n to stop running addbib. You can also enter the name of a text editor (vi, ex, edit, or ed) to edit the database. The addbib command insulates you from the options by displaying an equivalent ``English'' prompt for each option. By default, addbib displays prompts for the A, T, J, V, P, I, C, D, O, K, and X options. Here are the common options and their meanings: %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. %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). 2 January 1992
addbib(1) addbib(1)%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. EXAMPLES Here is a record of the data entry for one bibliographic reference using the default prompts: Instructions? n Author: R. Pike Title: - Author: B. W. Kernighan Title: Program Design in the UNIX System Environment Journal: Technical Journal Volume: 63 No. 8 Part 2 Pages: 1595-1605 Publisher: AT&T Bell Laboratories City: Short Hills, NJ Date: October 1984 Other: Keywords: Programming UNIX Abstract: (ctrl-d to end) Continue? n Here is what the database contains: %A R. Pike %A B. W. Kernighan %T Program Design in the UNIX System Environment %J Technical Journal %V 63 No. 8 Part 2 %P 1595-1605 %I AT&T Bell Laboratories %C Short Hills, NJ %D October 1984 %K Programming UNIX January 1992 3
addbib(1) addbib(1)LIMITATIONS Because addbib displays only the first 20 characters, the prompt strings in a user-defined prompt file should be less than or equal to 20 characters. If the prompt string is longer than 20 characters, addbib appends the option from the prompt file to the end of the truncated prompt string. FILES /usr/ucb/addbib Executable file SEE ALSO indxbib(1), lookbib(1), refer(1), roffbib(1), sortbib(1) 4 January 1992