man(1) Manual page archive


     MAN(1)                                                     MAN(1)

     NAME
          man - print pages of this manual

     SYNOPSIS
          man [ option ... ] [ chapter ] title ...

          man -k pattern

     DESCRIPTION
          Man locates and prints pages of this manual named title in
          the specified chapter. Title is given in lower case.  The
          chapter number is a single digit, 1-9; pages marked (3S) or
          (9.1), for example, belong to chapters 3 and 9 respectively.
          If no chapter is specified, pages in all chapters, including
          the unprinted appendix, are printed.

          On some machines a cache of preformatted pages is available.
          If so, and if neither option -t or -n is present, option -q,
          for quick printing, is assumed.

          The options are:

          -q   Copy cached pages to the standard output or, if they
               are out of date or unavailable, act as -n.  Any name
               from the NAME list at the top of the page will serve as
               a title in the cache.  If the standard output is
               directed to a terminal, filter it through ul(1).

          -t   Use troff(1) to place on the standard output intermedi-
               ate code to drive the typesetting devices of lp(1),
               apsend(1), or proof(9.1).

          -n   Print the pages on the standard output using nroff.

          -f   The titles are actual names of manual source files.
               Assume option -t unless -n is present.

          -k   Report the NAME lines of all manual pages that matches
               the pattern. The pattern is as in egrep; see gre(1).

          Under -t and -n further options, e.g. to specify the kind of
          terminal you have, are passed on to troff or nroff.

          From time to time a daemon updates cached pages that are out
          of date and supplies links for subsidiary entries.

     EXAMPLES
          man man
               Reproduce this page and man(6).

     MAN(1)                                                     MAN(1)

          man -t eqn eqnchar | lp
               Format the eqn and eqnchar pages and send them to the
               laser printer.

          man -k 'copy.*file|file.*copy'
               Look for file-copying utilities.

     FILES
          troff                  source for manual; this page is
          manual cache
          cache daemon; invoked by
                                 cron(8)

     SEE ALSO
          troff(1), man(6), apsend(1), lp(1), proof(9.1)

     BUGS
          The manual was intended to be typeset; some detail is sacri-
          ficed on terminals.
          You can't ask for manual pages named 1 through 9.
          Pages not available in the cache can be located by their
          proper titles only.
          Cache entries by subsidiary names are always deemed up to
          date.