$Revision: 1666 $
$Date: 2002-06-12 07:19:37 -0400 (Wed, 12 Jun 2002) $
manvolnum — A reference volume number
manvolnum ::= (#PCDATA|acronym
|emphasis
|trademark
|link
|olink
|ulink
|anchor
|remark
|subscript
|superscript
|inlinegraphic
|inlinemediaobject
|indexterm
|beginpage
)*
In a DocBook reference page, the ManVolNum
holds
the number of the volume in which the RefEntry
belongs.
The notion of a volume number is historical. UNIX manual pages (“man
pages”), for which RefEntry
was devised, were typically
stored in three ring binders. Each bound manual was a volume in a set
and contained information about a particular class of things. For
example, volume 1 was for user commands, and volume 8 was for administrator
commands.
Volume numbers need not be strictly numerical; volume “l” frequently held manual pages for local additions to the system, and the X Window System manual pages had an “x” in the volume number: for example, 1x.
The content of ManVolNum
is usually printed in parentheses
after the element title or citation.
The following elements occur in manvolnum:
acronym
, anchor
, beginpage
, emphasis
, indexterm
, inlinegraphic
, inlinemediaobject
, link
, olink
, remark
, subscript
, superscript
, trademark
, ulink
.
<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> <para> For a further description of print formats, consult the <citerefentry><refentrytitle>printf</refentrytitle> <manvolnum>3S</manvolnum></citerefentry> manual page. </para>
For a further description of print formats, consult the printf(3S) manual page.
For additional examples, see also
citerefentry
, refentry
.