|
|
1.1 root 1: .\" Copyright (c) 1983, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\"
5: .\" @(#)addbib.1 6.3 (Berkeley) 7/24/90
6: .\"
7: .Dd July 24, 1990
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
20: .Ql y
21: to the initial
22: .Ql Instructions?
23: prompt yields directions;
24: typing
25: .Ql n
26: or
27: .Ql RETURN
28: skips them.
29: .Nm Addbib
30: then prompts for various bibliographic fields,
31: reads responses from the terminal,
32: and sends output records to a
33: .Ar database .
34: A null response (just
35: .Ql RETURN )
36: means to leave out that field.
37: A minus sign
38: .Ql \-
39: means to go back to the previous field.
40: A trailing backslash allows a field to be continued on the next line.
41: The repeating
42: .Ql Continue?
43: prompt allows the user
44: either to resume by typing
45: .Ql y
46: or
47: .Ql RETURN ,
48: to quit the current session by typing
49: .Ql n
50: or
51: .Ql q ,
52: or to edit the
53: .Ar database
54: with any system editor (.e.g.
55: .Xr vi ,
56: .Xr ex ,
57: .Xr edit ,
58: .Xr ed ) .
59: .Pp
60: The
61: .Fl a
62: option suppresses prompting for an abstract;
63: asking for an abstract is the default.
64: Abstracts are ended with a
65: .Ql CTRL-d .
66: The
67: .Fl p
68: option causes
69: .Nm addbib
70: to use a new prompting skeleton, defined in
71: .Ar promptfile .
72: This file should contain prompt strings, a tab,
73: and the key-letters to be written to the
74: .Ar database .
75: .Pp
76: The most common key-letters and their meanings are given below.
77: .Nm Addbib
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.
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
139: Except for `A', each field should be given just once.
140: Only relevant fields should be supplied.
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
158: .Di L
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
170: Al Stangenberger, Bill Tuthill
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.