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