|
|
1.1 root 1: .\" Copyright (c) 1983 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)addbib.1 6.1 (Berkeley) 4/29/85
6: .\"
7: .TH ADDBIB 1 "April 29, 1985"
8: .UC 5
9: .SH NAME
10: addbib \- create or extend bibliographic database
11: .SH SYNOPSIS
12: \fBaddbib\fP [ \fB\-p\fP promptfile ] [ \fB\-a\fP ] database
13: .SH DESCRIPTION
14: When this program starts up, answering ``y''
15: to the initial ``Instructions?'' prompt yields directions;
16: typing ``n'' or \s-2RETURN\s0 skips them.
17: .I Addbib
18: then prompts for various bibliographic fields,
19: reads responses from the terminal,
20: and sends output records to a
21: .I database.
22: A null response (just \s-2RETURN\s0) means to leave out that field.
23: A minus sign (\-) means to go back to the previous field.
24: A trailing backslash allows a field to be continued on the next line.
25: The repeating ``Continue?'' prompt allows the user
26: either to resume by typing ``y'' or \s-2RETURN\s0,
27: to quit the current session by typing ``n'' or ``q'',
28: or to edit the
29: .I database
30: with any system editor \fI(vi, ex, edit, ed).\fP
31: .PP
32: The
33: .B \-a
34: option suppresses prompting for an abstract;
35: asking for an abstract is the default.
36: Abstracts are ended with a \s-2CTRL\s0-d.
37: The
38: .B \-p
39: option causes
40: .I addbib
41: to use a new prompting skeleton, defined in
42: .I promptfile.
43: This file should contain prompt strings, a tab,
44: and the key-letters to be written to the
45: .I database.
46: .PP
47: The most common key-letters and their meanings are given below.
48: .I Addbib
49: insulates you from these key-letters,
50: since it gives you prompts in English,
51: but if you edit the bibliography file later on,
52: you will need to know this information.
53: .sp
54: .nf
55: %A Author's name
56: %B Book containing article referenced
57: %C City (place of publication)
58: %D Date of publication
59: %E Editor of book containing article referenced
60: %F Footnote number or label (supplied by \fIrefer\fP\|)
61: %G Government order number
62: %H Header commentary, printed before reference
63: %I Issuer (publisher)
64: %J Journal containing article
65: %K Keywords to use in locating reference
66: %L Label field used by \fB\-k\fP option of \fIrefer\fP
67: %M Bell Labs Memorandum (undefined)
68: %N Number within volume
69: %O Other commentary, printed at end of reference
70: %P Page number(s)
71: %Q Corporate or Foreign Author (unreversed)
72: %R Report, paper, or thesis (unpublished)
73: %S Series title
74: %T Title of article or book
75: %V Volume number
76: %X Abstract \(em used by \fIroffbib\fP, not by \fIrefer\fP
77: %Y,Z ignored by \fIrefer\fP
78: .fi
79: .sp
80: Except for `A', each field should be given just once.
81: Only relevant fields should be supplied.
82: An example is:
83: .sp
84: .nf
85: %A Bill Tuthill
86: %T Refer \(em A Bibliography System
87: %I Computing Services
88: %C Berkeley
89: %D 1982
90: %O \s-1UNX\s0 4.3.5.
91: .fi
92: .sp
93: .SH FILES
94: .DT
95: promptfile optional file to define prompting
96: .SH SEE ALSO
97: refer(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1)
98: .SH AUTHORS
99: Al Stangenberger, Bill Tuthill
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.