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 key-
          letters and relevant fields.  For example, %A is the key-
          letter 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
          Instructions? 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
          RETURN, 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 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



     Page 1                                        (last mod. 1/20/87)

     addbib(1)                                               addbib(1)



               %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 - 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 - A Bibliography System
               %I   Computing Services
               %C   Berkeley
               %D   1982
               %O   UNX 4.3.5.


     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.  i.e.,
          addbib will only display the first 20 characters.  If the
          prompt string is longer than 20 characters, addbib will
          append the key-letter from the prompt file to the end of the
          truncated prompt string.

     SEE ALSO
          refer(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1).













     Page 2                                        (last mod. 1/20/87)