xref: /original-bsd/old/refer/addbib/addbib.1 (revision c577960b)
Copyright (c) 1983 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)addbib.1 6.1 (Berkeley) 04/29/85

ADDBIB 1 ""
C 5
NAME
addbib - create or extend bibliographic database
SYNOPSIS
addbib [ -p promptfile ] [ -a ] database
DESCRIPTION
When this program starts up, answering ``y'' to the initial ``Instructions?'' prompt yields directions; typing ``n'' or \s-2RETURN\s0 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 \s-2RETURN\s0) 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 \s-2RETURN\s0, to quit the current session by typing ``n'' or ``q'', or to edit the database with any system editor (vi, ex, edit, ed).

The -a option suppresses prompting for an abstract; asking for an abstract is the default. Abstracts are ended with a \s-2CTRL\s0-d. The -p option causes addbib to use a new prompting skeleton, defined in promptfile. This file should contain prompt strings, a tab, and the key-letters to be written to the database.

The most common key-letters and their meanings are given below. Addbib insulates you from these key-letters, since it gives you prompts in English, but if you edit the bibliography 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
 %I Issuer (publisher)
 %J Journal containing article
 %K Keywords to use in locating reference
 %L Label field used by -k option of refer
 %M Bell Labs Memorandum (undefined)
 %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 \(em used by roffbib, not by refer
 %Y,Z ignored by refer
Except for `A', each field should be given just once. Only relevant fields should be supplied. An example is:
 %A Bill Tuthill
 %T Refer \(em A Bibliography System
 %I Computing Services
 %C Berkeley
 %D 1982
 %O \s-1UNX\s0 4.3.5.
FILES
promptfile optional file to define prompting
SEE ALSO
refer(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1)
AUTHORS
Al Stangenberger, Bill Tuthill