4BSD/usr/man/cat1/man.1

Compare this file to the similar file:
Show the results in this format:




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 form 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, i.e. 3, which
     may be followed by a single letter classifier, i.e. 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, or if the flag - is
     given, then _m_a_n pipes its output through _c_a_t(1) with the
     option -s to crush out useless blank lines, _u_l(1) to create
     proper underlines for different terminals, and through
     _m_o_r_e(1) 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 to a suitable raster output device; see
     _v_t_r_o_f_f(1).

FILES
     /usr/man/man?/*
     /usr/man/cat?/*





Printed 11/10/80                                                1






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



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

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 11/10/80                                                2