1.\" Copyright (c) 1983, 1990 The Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" 5.\" @(#)addbib.1 6.2 (Berkeley) 06/11/90 6.\" 7.Dd 8.Os BSD 4.2 9.Dt ADDBIB 1 10.Sh NAME 11.Nm addbib 12.Nd create or extend bibliographic database 13.Sh SYNOPSIS 14.Nm addbib 15.Op Fl p Ar promptfile 16.Op Fl a 17.Ar database 18.Sh DESCRIPTION 19When this program starts up, answering 20.Li y 21to the initial 22.Li Instructions? 23prompt yields directions; 24typing 25.Li n 26or 27.Li RETURN 28skips them. 29.Nm Addbib 30then prompts for various bibliographic fields, 31reads responses from the terminal, 32and sends output records to a 33.Ar database . 34A null response (just 35.Li RETURN ) 36means to leave out that field. 37A minus sign 38.Li (\-) 39means to go back to the previous field. 40A trailing backslash allows a field to be continued on the next line. 41The repeating 42.Li Continue? 43prompt allows the user 44either to resume by typing 45.Li y 46or 47.Li RETURN , 48to quit the current session by typing 49.Li n 50or 51.Li q , 52or to edit the 53.Ar database 54with any system editor (.e.g. 55.Xr vi , 56.Xr ex , 57.Xr edit , 58.Xr ed ) . 59.Pp 60The 61.Fl a 62option suppresses prompting for an abstract; 63asking for an abstract is the default. 64Abstracts are ended with a 65.Li CTRL-d . 66The 67.Fl p 68option causes 69.Nm addbib 70to use a new prompting skeleton, defined in 71.Ar promptfile . 72This file should contain prompt strings, a tab, 73and the key-letters to be written to the 74.Ar database . 75.Pp 76The most common key-letters and their meanings are given below. 77.Nm Addbib 78insulates you from these key-letters, 79since it gives you prompts in English, 80but if you edit the bibliography file later on, 81you will need to know this information. 82.Dw \&%Y,Z 83.Dp \&%A 84Author's name 85.Dp \&%B 86Book containing article referenced 87.Dp \&%C 88City (place of publication) 89.Dp \&%D 90Date of publication 91.Dp \&%E 92Editor of book containing article referenced 93.Dp \&%F 94Footnote number or label (supplied by 95.Xr refer ) 96.Dp \&%G 97Government order number 98.Dp \&%H 99Header commentary, printed before reference 100.Dp \&%I 101Issuer (publisher) 102.Dp \&%J 103Journal containing article 104.Dp \&%K 105Keywords to use in locating reference 106.Dp \&%L 107Label field used by 108.Fl k 109option of 110.Xr refer 111.Dp \&%M 112Memorandum label 113.Dp \&%N 114Number within volume 115.Dp \&%O 116Other commentary, printed at end of reference 117.Dp \&%P 118Page number(s) 119.Dp \&%Q 120Corporate or Foreign Author (unreversed) 121.Dp \&%R 122Report, paper, or thesis (unpublished) 123.Dp \&%S 124Series title 125.Dp \&%T 126Title of article or book 127.Dp \&%V 128Volume number 129.Dp \&%X 130Abstract \(em used by 131.Xr roffbib , 132not by 133.Xr refer 134.Dp \&%Y,Z 135ignored by 136.Xr refer 137.Dp 138.Pp 139Except for `A', each field should be given just once. 140Only relevant fields should be supplied. 141.Sh EXAMPLES 142.Dw \&%Y,Z 143.Dp %A 144Bill Tuthill 145.Dp %T 146Refer \(em A Bibliography System 147.Dp %I 148Computing Services 149.Dp %C 150Berkeley 151.Dp %D 1521982 153.Dp %O 154\s-1UNX\s0 4.3.5. 155.Dp 156.Sh FILES 157.Dw promptfile 158.Dp Pa promptfile 159optional file to define prompting 160.Sh SEE ALSO 161.Xr refer 1 , 162.Xr sortbib 1 , 163.Xr roffbib 1 , 164.Xr indxbib 1 , 165.Xr lookbib 1 166.Sh HISTORY 167appeared in 4.2 BSD. 168.Sh AUTHORS 169Al Stangenberger, Bill Tuthill 170