man(1)
_________________________________________________________________
man Command
print entries from the reference manuals
_________________________________________________________________
SYNTAX
man [ options ] [ section ] titles
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 runtime or system call 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 help
term2. The default value of term is 605x.
-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.
Section may be changed before each title.
As an example:
man man
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
man(1)
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 manual, Programmer's Reference manual, and
System Manager's Reference 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, p, or a to the name of the entry you want to
specify that you want it to come from the User's Reference for
the DG/UX System, Programmer's Reference for the DG/UX System, or
System Manager's Reference for the DG/UX System.
If you request a Chapter 0 entry but forget to append a u, p, or
a, in a man(1) command, 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.
TITLE u,p,a: The title page, copyright notice, and
release information
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
APPENDIX_A u,p: in the User's Reference for the DG/UX
System, an introduction to the shell programming
language; in the Programmer's Reference for the
DG/UX System, an introduction to networking
facilities
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
man(1)
_________________________________________________________________
EXAMPLES
$ man mkdir
The above example will give all of the online information about
the command, mkdir. 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]/* Preformatted 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 man(1).
Printing on other printers or typesetting requires the addition
of the Documenter's Toolkit and the man page source files (only
formatted entries are included for use by the man command).
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)