diff options
Diffstat (limited to 'refer/addbib.1')
| -rw-r--r-- | refer/addbib.1 | 195 |
1 files changed, 195 insertions, 0 deletions
diff --git a/refer/addbib.1 b/refer/addbib.1 new file mode 100644 index 0000000000000..c8aac57d3bb85 --- /dev/null +++ b/refer/addbib.1 @@ -0,0 +1,195 @@ +.\" Copyright (c) 1983 Regents of the University of California. +.\" All rights reserved. +.\" +.\" This code contains changes by +.\" Gunnar Ritter, Freiburg i. Br., Germany, 2005. All rights reserved. +.\" +.\" Conditions 1, 2, and 4 and the no-warranty notice below apply +.\" to these changes. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowedgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" Copyright(C) Caldera International Inc. 2001-2002. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" Redistributions of source code and documentation must retain the +.\" above copyright notice, this list of conditions and the following +.\" disclaimer. +.\" Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed or owned by Caldera +.\" International, Inc. +.\" Neither the name of Caldera International, Inc. nor the names of +.\" other contributors may be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" USE OF THE SOFTWARE PROVIDED FOR UNDER THIS LICENSE BY CALDERA +.\" INTERNATIONAL, INC. AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL CALDERA INTERNATIONAL, INC. BE +.\" LIABLE FOR ANY DIRECT, INDIRECT INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR +.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE +.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, +.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" Sccsid @(#)addbib.1b 1.4 (gritter) 12/12/05 +.\" +.\" +.\" from 4.3BSD-Tahoe addbib.1 6.1 (Berkeley) 4/29/85 +.\" +.\".TH ADDBIB 1 "April 29, 1985" +.Dd December 12, 2005 +.Dt ADDBIB 1 +.Os +.Sh NAME +.Nm addbib +.Nd create or extend bibliographic database +.Sh SYNOPSIS +.Nm +.Op Fl p Ar promptfile +.Op Fl a +.Ar database +.Sh DESCRIPTION +When this program starts up, answering +.Sq y +to the initial +.Dq Instructions? +prompt yields directions; typing +.Sq n +or +.Cm RETURN +skips them. +.Nm +then prompts for various bibliographic fields, reads responses from the +terminal, and sends output records to a +.Ar database . +A null response +.Aq just Cm RETURN +means to leave out that field. A minus sign +.Aq - +means to go back to the previous field. A trailing backslash allows a field to +be continued on the next line. The repeating +.Dq Continue? +prompt allows the user either to resume by typing +.Sq y +or +.Cm RETURN , +to quit the current session by typing +.Sq n +or +.Sq q , +or to edit the +.Ar database +with any system editor +.Aq Cm vi , Cm ex , Cm edit , Cm ed , +.Pp +The +.Fl a +option suppresses prompting for an abstract; asking for an abstract is the +default. Abstracts are ended with a +.Cm CTRL-d . +The +.Fl p +option causes +.Nm +to use a new prompting skeleton, defined in +.Ar promptfile . +This file should contain prompt strings, a tab, and the key-letters to be +written to the +.Ar database . +.Pp +The most common key-letters and their meanings are given below. +.Nm +insulates you from these key-letters, since it gives you prompts in English, +but if you edit the bibliography file later on, you will need to know this +information. +.Bl -column "Col1, Col2" +.It Sx \&%A Ta Author's name +.It Sx \&%B Ta Book containing article referenced +.It Sx \&%C Ta City (place of publication) +.It Sx \&%D Ta Date of publication +.It Sx \&%E Ta Editor of book containing article referenced +.It Sx \&%F Ta Footnote number or label (supplied by Cm refer ) +.It Sx \&%G Ta Government order number +.It Sx \&%H Ta Header commentary, printed before reference +.It Sx \&%I Ta Issuer (publisher) +.It Sx \&%J Ta Journal containing article +.It Sx \&%K Ta Keywords to use in locating reference +.It Sx \&%L Ta Label field used by Fl k +option of +.Cm refer +.It Sx \&%M Ta Bell Labs Memorandum (undefined) +.It Sx \&%N Ta Number within volume +.It Sx \&%O Ta Other commentary, printed at end of reference +.It Sx \&%P Ta Page number(s) +.It Sx \&%Q Ta Corporate or Foreign Author (unreversed) +.It Sx \&%R Ta Report, paper, or thesis (unpublished) +.It Sx \&%S Ta Series title +.It Sx \&%T Ta Title of article or book +.It Sx \&%V Ta Volume number +.It Sx \&%X Ta Abstract \(em used by Cm roffbib , +not by +.Cm refer +.It Sx %Y,Z Ta ignored by Cm refer +.El +.sp +Except for +.Sq A , +each field should be given just once. Only relevant fields should be supplied. +An example is: +.Bl -column "Col1, Col2" +.It Sx \&%A Ta Bill Tuthill +.It Sx \&%T Ta Refer \(em A Bibliography System +.It Sx \&%I Ta Computing Services +.It Sx \&%C Ta Berkeley +.It Sx \&%D Ta 1982 +.It Sx \&%O Ta Cm UNX 4.3.5. +.El +.Sh FILES +.Bl -tag -width promptfile +.It promptfile +optional file to define prompting +.El +.Sh SEE ALSO +.Xr indxbib 1 , +.Xr lookbib 1 , +.Xr refer 1 , +.Xr roffbib 1 , +.Xr sortbib 1 +.Sh NOTES +Written by Al Stangenberger & Bill Tuthill. |