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