SysIII/usr/src/man/docs/mm_man/s11ref

.H 1 "REFERENCES"
There are two macros that delimit the text of references, a string used
to automatically number the references, and an optional macro to produce
reference pages within the document.
.H 2 "Automatic Numbering of References"
Automatically numbered references
may be obtained by typing \e*(Rf
immediately after the text to be
referenced.
This places the next sequential reference
number (in a smaller point size) enclosed in brackets a half-line above
the text to be referenced, as illustrated by this document.
.H 2 "Delimiting Reference Text"
The \f3.\fPRS and \f3.\fPRF macros are used to delimit text for
each reference.
.Es 1
A line of text to be referenced.\e*(Rf
\&\f3.\fPRS [string-name]
reference text
\&\f3.\fPRF
.Ee
.H 2 "Subsequent References"
\&.RS takes one argument, a
.I string-name .
For example:
.Es 1
\&\f3.\fPRS AA
reference text
\&\f3.\fPRF
.Ee
.P
The string
.I AA
is assigned the current reference number.
It may be used later in the document,
as the string call,
.I \e*(AA ,
to reference text which must be labeled
with a prior reference number.
The reference is output enclosed in brackets a half-line
above the text to be referenced.
No \f3.\fPRS/\f3.\fPRF is needed for subsequent references.
.H 2 "Reference Page"
An automatically generated reference page is
produced at the end of the document before the
Table of Contents and the Cover Sheet are output.
The reference page is entitled ``References''.
This page contains the reference text (RS/RF).
The user may change the Reference Page title
by defining the
.I Rp
string.  For example,
.Es 1
\&\f3.\fPds Rp "New Title"
.Ee
.P
The optional \f3.\fPRP (Reference Page) macro may be used to produce
reference pages anywhere within a document (i.e.,
within heading sections).
.Es 1
\&\f3.\fPRP [arg1] [arg2]
.Ee
.P
These arguments allow the user to control
resetting of reference numbering, and page skipping.
.! tbl tbl-11.3
\&\f3.\fPRP need not be used unless the user
wishes to produce reference pages elsewhere in the
document.