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′′×11′′). 

−s Typeset the entry in the small format (6′′×9′′). 

−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 terminal); 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. 

−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′′×9′′ 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 terminal 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 identifying 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 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/u_man/man[1,6]/∗
the CX/UX User’s Reference Manual

/usr/man/a_man/man[1,7,8]/∗
the CX/UX Administrator’s Reference Manual

/usr/man/p_man/man[2-5]/∗
the CX/UX Programmer’s Reference 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′′×9′′ manual entries formatted by nroff (with the −rs1 option) are not guaranteed to look as good as regular-sized entries. 

CX/UX User’s Reference Manual