oman(1) oman(1)
NAME
oman, manprog - print entries in this manual
SYNOPSIS
oman [ options ] [ section ] titles
/usr/lib/manprog file
DESCRIPTION
oman locates and prints the entry of this manual named title
in the specified section. (For historical reasons, the word
``page'' is often used as a synonym for ``entry'' in this
context.) The title is entered in lower case. The section
number may not have a letter suffix. If no section is
specified, the whole manual is searched for title and all
occurrences of it are printed. Options and their meanings
are:
-t Typeset the entry in the default format
(8.5"x11").
-s Typeset the entry in the small format (6"x9").
-D4014 Display the typeset output on a TEKTRONIX 4014
terminal using tc(1).
-Dtek Same as -D4014.
-Di10 Send typeset output to the local Imagen Imprint-
10 laser printer.
-Tterm If term is one of the recognized troff devices
(see troff(1)), format the entry for that device.
Otherwise format the entry using nroff and print
it on the standard output (usually, the termi-
nal); term is the terminal type (see term(5) and
the explanation below); for a list of recognized
values of term, type help term2. The default
value of term is 450.
-w Print on the standard output only the pathnames
of the entries, relative to /usr/man, or to the
current directory for -d option.
-d Search the current directory rather than
/usr/man; requires the full file name (e.g.,
cu.1c, rather than just cu).
-12 Indicates that the manual entry is to be produced
in 12-pitch. May be used when $TERM (see below)
is set to one of 300, 300s, 450, and 1620. (The
pitch switch on the DASI 300 and 300s terminals
must be manually set to 12 if this option is
used.)
-c Causes oman to invoke col(1); note that col(1) is
invoked automatically by oman unless term is one
of 300, 300s, 450, 37, 4000a, 382, 4014, tek,
1620, and X.
-y Causes oman to use the compacted version of the
macros.
Page 1 CX/UX User's Reference Manual
oman(1) oman(1)
-z Invokes no output filter to process or redirect
the output of troff(1).
The above options other than -d, -c, and -y are mutually
exclusive, except that the -s and -z options may be used in
conjunction with any typesetter option (6"x9" pages may be
produced with nroff by including the -rs1 option). Any
other options are passed to troff, nroff, or the man(5)
macro package.
When using nroff, oman examines the environment variable
$TERM (see environ(5)) and attempts to select options to
nroff, as well as filters, that adapt the output to the ter-
minal being used. The -Tterm option overrides the value of
$TERM; in particular, one should use -Tlp when sending the
output of oman to a line printer.
Section may be changed before each title.
As an example:
oman oman
would reproduce on the terminal this entry, as well as any
other entries named oman that may exist in other sections of
the manual.
If the first line of the input for an entry consists solely
of the string:
'\" x
where x is any combination of the two characters e, and t,
and where there is exactly one blank between the double
quote (") and x, then oman will preprocess its input through
the appropriate combination of eqn(1) (neqn for nroff) and
tbl(1), respectively. If qn or neqn are invoked, they will
automatically read the file /usr/pub/eqnchar (see
eqnchar(5)).
The oman command executes manprog that takes a file name as
its argument. Manprog calculates and returns a string of
three register definitions used by the formatters identify-
ing the date the file was last modified. The returned
string has the form:
-rdday -rmmonth -ryyear
and is passed to nroff which sets this string as variables
for the man macro package. Months are given from 0 to 11,
therefore month is always 1 less than the actual month. The
man macros calculate the correct month. If the man macro
Page 2 CX/UX User's Reference Manual
oman(1) oman(1)
package is invoked as an option to nroff / troff (i.e.,
nroff -man file), then the current day/month/year is used as
the printed date.
FILES
/usr/man/uman/man[1,6]/* the CX/UX User's Reference
Manual
/usr/man/aman/man[1,7,8]/* the CX/UX Administrator's
Reference Manual
/usr/man/pman/man[2-5]/* the CX/UX Programmer's Refer-
ence Manual
/usr/man/local/man[1-8]/* local additions
/usr/man/*/man[1-8]/* any other additions
/usr/lib/manprog calculates modification dates
of entries
SEE ALSO
eqn(1), nroff(1), tbl(1), tc(1), troff(1), environ(5),
man(5), term(5).
BUGS
All entries are supposed to be reproducible either on a
typesetter or on a terminal. However, on a terminal some
information is necessarily lost.
Pages bearing the same name in all three manuals will result
in the CX/UX Administrator's Reference Manual entry being
printed first, if no section argument is supplied.
6"x9" manual entries formatted by nroff (with the -rs1
option) are not guaranteed to look as good as regular-sized
entries.
Page 3 CX/UX User's Reference Manual