manual page distributed with 4.1BSD
authorKirk McKusick <mckusick@ucbvax.Berkeley.EDU>
Tue, 30 Apr 1985 11:10:36 +0000 (03:10 -0800)
committerKirk McKusick <mckusick@ucbvax.Berkeley.EDU>
Tue, 30 Apr 1985 11:10:36 +0000 (03:10 -0800)
SCCS-vsn: old/iul/iul.1 4.1
SCCS-vsn: old/man/newgrp.1 4.1
SCCS-vsn: old/refer/refer/refer.1 4.1

usr/src/old/iul/iul.1 [new file with mode: 0644]
usr/src/old/man/newgrp.1 [new file with mode: 0644]
usr/src/old/refer/refer/refer.1 [new file with mode: 0644]

diff --git a/usr/src/old/iul/iul.1 b/usr/src/old/iul/iul.1
new file mode 100644 (file)
index 0000000..e8bf9c0
--- /dev/null
@@ -0,0 +1,8 @@
+.\"    @(#)iul.1       4.1 (Berkeley) %G%
+.\"
+.TH IUL 1 "4/1/81"
+.AT 3
+.pl 1
+The ``iul'' command is obsolete.  Use the ``-i'' (indicate) option to
+the ``ul'' command instead.  Thus ``nroff -ms foo | iul'' is replaced
+by ``nroff -ms foo | ul -i''.
diff --git a/usr/src/old/man/newgrp.1 b/usr/src/old/man/newgrp.1
new file mode 100644 (file)
index 0000000..525538e
--- /dev/null
@@ -0,0 +1,30 @@
+.\"    @(#)newgrp.1    4.1 (Berkeley) %G%
+.\"
+.TH NEWGRP 1 
+.AT 3
+.SH NAME
+newgrp \- log in to a new group
+.SH SYNOPSIS
+.B newgrp
+group
+.SH DESCRIPTION
+.I Newgrp
+changes the group identification of its caller,
+analogously to
+.IR  login (1).
+The same person remains logged in,
+and the current directory is unchanged,
+but calculations of access permissions to files are
+performed with respect to the
+new group ID.
+.PP
+A password is demanded if the group has
+a password and the user himself does not.
+.PP
+.I Newgrp
+is known to the shell, which executes it directly without a fork.
+.SH FILES
+/etc/group, /etc/passwd
+.SH "SEE ALSO"
+login(1), group(5)
+.SH BUGS
diff --git a/usr/src/old/refer/refer/refer.1 b/usr/src/old/refer/refer/refer.1
new file mode 100644 (file)
index 0000000..6096f6a
--- /dev/null
@@ -0,0 +1,164 @@
+.\"    @(#)refer.1     4.1 (Berkeley) %G%
+.\"
+.TH REFER 1 4/1/81
+.AT 3
+.SH NAME
+refer, lookbib \- find and insert literature references in documents
+.SH SYNOPSIS
+.B refer
+[ option ] ...
+.PP
+.B lookbib
+[ file ] ...
+.SH DESCRIPTION
+.I Lookbib
+accepts keywords from the standard input 
+and searches a bibliographic data base for references
+that contain those keywords anywhere in title, author,
+journal name, etc.
+Matching references are printed on the standard output.
+Blank lines are taken as delimiters between queries.
+.PP
+.I Refer
+is a preprocessor for
+.I nroff
+or
+.IR troff (1)
+that finds and formats references.
+The input files (standard input default) are copied to the standard output,
+except for lines between .[ and .]
+command lines, which are assumed to contain keywords as for
+.I lookbib,
+and are replaced by information from the bibliographic data base.
+The user may avoid the search, override fields from it, or
+add new fields.
+The reference data, from whatever source, are assigned to a set of
+.I troff
+strings.
+Macro packages such as
+.IR ms (7)
+print the finished reference text from these strings.
+A flag is placed in the text at the point of reference;
+by default the references are indicated by numbers.
+.br
+.sp
+The following options are available:
+.TP 6
+.BI \-a r
+Reverse the first
+.I r
+author names (Jones, J. A. instead of J. A. Jones).
+If
+.I r
+is omitted all author names are reversed.
+.ns
+.TP
+.B \-b
+Bare mode: do not put any flags in text (neither numbers nor labels).
+.ns
+.TP
+.BI \-c string
+Capitalize (with C\s-2APS\s0 S\s-2MALL\s+2 C\s-2APS\s0)
+the fields whose key-letters are in
+.IR string .
+.ns
+.TP
+.B \-e
+Instead of leaving the references where encountered,
+accumulate them
+until a sequence of the form
+.nf
+               .[
+               $LIST$
+               .]
+.fi
+is encountered, and then write out all references
+collected so far.  Collapse references to the same source.
+.ns
+.TP
+.BI \-k x
+Instead of numbering references, use labels as specified in
+a
+reference data line
+beginning
+.I %x;
+by default 
+.I x
+is
+.B L.
+.ns
+.TP
+.BI \-l m , n
+Instead of numbering references, use labels made from
+the senior author's last name and the year of publication.
+Only the first
+.I m
+letters of the last name
+and the last
+.I n
+digits of the date are used.
+If either
+.I m
+or
+.BI , n
+is omitted the entire name or date respectively is used.
+.ns
+.TP
+.B \-p
+Take the next argument as a file of
+references to be searched.
+The default file is searched last.
+.ns
+.TP
+.B \-n
+Do not search the default file.
+.ns
+.TP
+.BI \-s keys
+Sort references by fields whose key-letters are in
+the
+.I keys
+string;
+permute
+reference numbers in text accordingly.
+Implies
+.BR \-e .
+The key-letters in
+.I keys
+may be followed by a number to indicate how many such fields
+are used, with
+.B +
+taken as a very large number.
+The default is
+.B AD
+which sorts on the senior author and then date; to sort, for example,
+on all authors and then title use
+.BR -sA+T .
+.PP
+.\"To use your own references, put them in the format
+.\"described in
+.\".IR pubindex (1)
+.\"They can be searched
+.\"more rapidly by running
+.\".IR pubindex (1)
+.\"on them before using
+.\".I refer;
+.\"failure to index results in a linear search.
+.PP
+When
+.I refer
+is used with
+.I eqn,
+.I neqn
+or
+.I tbl,
+.I refer
+should be first, to minimize the volume
+of data passed through
+pipes.
+.SH FILES
+.ta 1.5i
+/usr/dict/papers       directory of default publication lists and indexes
+.br
+/usr/lib/refer directory of programs
+.SH SEE ALSO