man(1) DG/UX 4.30 man(1)
NAME
man - print entries from the reference manuals
SYNOPSIS
man [ options ] [ section ] title [ title ]...
DESCRIPTION
Man 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 lowercase. 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.
In many cases, more than one command or system call or
routine is listed under a single entry name; for example the
ln and mv commands are described in the cp(1) manual page.
With many UNIX® incarnations, this meant that you could only
get help if you knew the entry name as well as the command
name. In DG/UX, you can use the command name; the man(1)
command will print the correct entry. Options are:
-Tterm Print the entry as appropriate for terminal type
term. For a list of recognized values of term,
type man term. The default is the type specified
by the TERM environment variable.
-w Print on the standard output only the pathnames
of the entries, relative to /usr/catman, or to
the current directory for -d option.
-d Search the current directory rather than
/usr/catman; requires the full file name (e.g.,
uux.1c, rather than just uux).
Man examines the environment variable $TERM (see environ(5))
and tries to select options that adapt the output to the
terminal being used. The -Tterm option overrides the value
of $TERM. You should use the -Tlp switch when sending the
output to a line printer.
If man finds that the $PAGER environment variable is
defined, it assumes that the value is a command, possibly
with options, to which the output should be piped
(generally, to paginate the output).
Additional directories may be specified using the $MANPATH
environment variable. This variable may contain a space-
separated list of directories; the entries should be in
these directories or in subdirectories with names of the
form manx for a digit x.
Licensed material--property of copyright holder(s) Page 1
man(1) DG/UX 4.30 man(1)
Section may be changed before each title.
As an example:
man man
would reproduce on the terminal this entry, as well as any
other entries named man that may exist in other sections of
the manual.
CHAPTER 0 ENTRIES
The User's Reference for the DG/UX System manual,
Programmer's Reference for the DG/UX System manual, and
System Manager's Reference for the DG/UX System manual have
some Chapter 0 titles in common.
When you use the man(1) command to access a (0)-suffix
chapter, you must specify which manual you want.
Just append a u (for "user"), p (for "programmer"), or a
(for "administrator") to the name of the entry you want,
thereby specifying that you are referring to the User's
Reference for the DG/UX System, the Programmer's Reference
for the DG/UX System, or the System Manager's Reference for
the DG/UX System, respectively.
If you request a Chapter 0 entry but forget to append u, p,
or a to the entry name, you get a syntax reminder printed on
the standard output. It is named syntax(0) and is formatted
to look like a manual entry.
Chapter Name Reference
Here is a listing of the (0) chapters, with an indication of
which manuals have them.
PREF u,p,a: The preface; a discussion of the
manual's purpose and organization and a
listing of the DG/UX System manual set and
related manuals.
CONTENTS u,p,a: The table of contents
INDEX u,p,a: The permuted index
INTRO u: A general introduction to the system
Licensed material--property of copyright holder(s) Page 2
man(1) DG/UX 4.30 man(1)
EXAMPLES
$ man mkdir
The command above will give all of the online information
about the mkdir(1) command. For some commands there are
several chapter entries. If the user knows the chapter of
the desired command, the chapter number can follow the man
command, with the desired command. (For example, man 2
write).
FILES
/usr/catman/?_man/man[1-8]/* Formatted manual entries
SEE ALSO
term(5) in the Programmer's Reference for the DG/UX System
WARNING
The man command prints manual entries that were formatted by
nroff before the system was installed. Entries are
specially formatted for processing by ul(1), which is called
by the man command. Printing on other printers or
typesetting requires the addition of the Documenter's Tool
Kit and the man page source files (only formatted entries
are included for use by the man command).
Licensed material--property of copyright holder(s) Page 3