MAN(1)              UNIX Programmer's Manual               MAN(1)

NAME
     man - find manual information by keywords; print out the
     manual

SYNOPSIS
     man -k keyword ...
     man -f file ...
     man [ - ] [ -t ] [ section ] title ...

DESCRIPTION
     _M_a_n is a program which gives information from the program-
     mers manual.  It can be asked for one line descriptions of
     commands specified by name, or for all commands whose
     description contains any of a set of keywords.  It can also
     provide on-line access to the sections of the printed
     manual.

     When given the option -k and a set of keywords, _m_a_n prints
     out a one line synopsis of each manual sections whose list-
     ing in the table of contents contains that keyword.

     When given the option -f and a list of file names, _m_a_n
     attempts to locate manual sections related to those files,
     printing out the table of contents lines for those sections.

     When neither -k nor -f is specified, _m_a_n formats a specified
     set of manual pages.  If a section specifier is given _m_a_n
     looks in the that section of the manual for the given
     _t_i_t_l_e_s. _S_e_c_t_i_o_n is an Arabic section number, e.g. 3, which
     may be followed by a single letter classifier, e.g. 1g indi-
     cating a graphics program in section 1.  If _s_e_c_t_i_o_n is omit-
     ted, _m_a_n searches all sections of the manual, giving prefer-
     ence to commands over subroutines in system libraries, and
     printing the first section it finds, if any.

     If the standard output is a teletype, and if the flag - is
     not given, then _m_a_n prints its output with _m_o_r_e(1) with the
     -s option to eliminate multiple blank lines, to create
     proper underlines for different terminals, to stop after
     each page on the screen.  Hit a space to continue, a
     control-D to scroll 11 more lines when the output stops.

     The -t flag causes _m_a_n to arrange for the specified section
     to be _t_r_o_f_f'_e_d.

FILES
     /usr/man/man?       directories for raw manual pages
     /usr/man/cat?       directories for formatted manual pages

SEE ALSO
     apropos(1), more(1), whereis(1), catman(8)

Printed 5/16/83                                                 1

MAN(1)              UNIX Programmer's Manual               MAN(1)

BUGS
     The manual is supposed to be reproducible either on the pho-
     totypesetter or on a typewriter.  However, on a typewriter
     some information is necessarily lost.

Printed 5/16/83                                                 2