


man(1)                                                     man(1)


NNAAMMEE
       man - format and display the on-line manual pages

SSYYNNOOPPSSIISS
       man  [-adfhktw]  [-m  system]  [-p  string]  [-M path] [-P
       pager] [-S list] [section] name ...

DDEESSCCRRIIPPTTIIOONN
       man formats and displays the on-line manual  pages.   This
       version  knows  about  the  MANPATH  and PAGER environment
       variables, so you can have your own set(s) of personal man
       pages  and choose whatever program you like to display the
       formatted pages.  If section is specified, man only  looks
       in  that  section of the manual.  You may also specify the
       order to search the sections for entries and which prepro-
       cessors  to  run  on  the  source  files  via command line
       options or environment variables.

OOPPTTIIOONNSS
       --MM  ppaatthh
              Specify an alternate manpath.  By default, man uses
              mmaannppaatthh  to  determine  the  path  to search.  This
              option overrides the MMAANNPPAATTHH environment  variable.

       --PP  ppaaggeerr
              Specify  which  pager to use.  By default, man uses
              //uussrr//bbiinn//lleessss --ssCC,, This option overrides the  PPAAGGEERR
              environment variable.

       --SS  lliisstt
              List  is  a colon separated list of manual sections
              to search.  This option overrides the MMAANNSSEECCTT envi-
              ronment variable.

       --aa     By  default,  man  will  exit  after displaying the
              first manual page  it  finds.   Using  this  option
              forces  man  to  display  all the manual pages that
              match nnaammee,, not just the first.

       --dd     Don't actually display the man pages, but do  print
              gobs of debugging information.

       --ff     Equivalent to wwhhaattiiss..

       --hh     Print a one line help message and exit.

       --kk     Equivalent to aapprrooppooss..

       --mm  ssyysstteemm
              Specify  an  alternate  set  of man pages to search
              based on the system name given.

       --pp  ssttrriinngg
              Specify the sequence of preprocessors to run before



                           Jan 5, 1991                          1





man(1)                                                     man(1)


              nroff  or troff.  Not all installations will have a
              full set of preprocessors.  Some of the  preproces-
              sors  and  the  letters used to designate them are:
              eqn (e), grap (g), pic (p), tbl  (t),  vgrind  (v),
              refer  (r).   This  option overrides the MMAANNRROOFFFFSSEEQQ
              environment variable.

       --tt     Use //uussrr//bbiinn//ggrrooffff --TTaasscciiii --mmaannddoocc  to  format  the
              manual  page,  passing  the  output to ssttddoouutt..  The
              output from //uussrr//bbiinn//ggrrooffff --TTaasscciiii --mmaannddoocc may need
              to  be passed through some filter or another before
              being printed.

       --ww     Don't actually display the man pages, but do  print
              the  location(s) of the files that would be format-
              ted or displayed.

EENNVVIIRROONNMMEENNTT
       MMAANNPPAATTHH     If MMAANNPPAATTHH is set, its value is  used  as  the
                   path to search for manual pages.

       MMAANNRROOFFFFSSEEQQ  If  MMAANNRROOFFFFSSEEQQ  is  set,  its value is used to
                   determine the set of preprocessors run  before
                   running nroff or troff.  By default, pages are
                   passed through the table  preprocessor  before
                   nroff.

       MMAANNSSEECC      If  MMAANNSSEECC is set, its value is used to deter-
                   mine which manual sections to search.

       PPAAGGEERR       If PPAAGGEERR is set, its value is used as the name
                   of the program to use to display the man page.
                   By default, //uussrr//bbiinn//lleessss --ssCC is used.

SSEEEE AALLSSOO
       apropos(1), whatis(1), manpath(1), less(1), groff(1).

BBUUGGSS
       The --tt option  only  works  if  a  troff-like  program  is
       installed.

















                           Jan 5, 1991                          2


