Provided by: man-db_2.5.7-4_i386 bug

man -

man [-C ] [-d] [-D]

       [--warnings[=]]  [-R  ]  [-L  ] [-m [,...]] [-M ] [-S  ] [-e .] [-i|-I]
       [--regex|--wildcard] [--names-only] [-a] [-u] [--no-subpages] [-P ] [-r
       ]  [-7] [-E ] [--no-hyphenation] [--no-justification] [-p ] [-t] [-T[]]
       [-H[]] [-X[dpi]] [-Z] [[]  ...] ...
       man -k [apropos ]  ...
       man -K [-w|-W] [-S ] [-i|-I] [--regex] []  ...
       man -f [whatis ]  ...
       man -l [-C ] [-d] [-D] [--warnings[=]] [-R ] [-L ] [-P ] [-r ] [-7] [-E
       ]  [-p  ] [-t] [-T[]] [-H[]] [-X[dpi]] [-Z]  ... man -l [-C ] [-d] [-D]
       [--warnings[=]] [-R ] [-L ] [-P ] [-r ] [-7] [-E ] [-p  ]  [-t]  [-T[]]
       [-H[]] [-X[dpi]] [-Z]  ...
       man -w|-W [-C ] [-d] [-D]
        ...
       man -c [-C ] [-d] [-D] ...
       man [-hV]

man -- .

       ,  man,    ,
         .
           .    ,
         man .

       ,       .

       .

       1        (shell)
       2     (,  )
       3     (,   )
       4     (    /dev)
       5      ,  /etc/passwd
       6
       7    (       ),    ,   man(7),
           groff(7)
       8      (,   )
       9     [ ]

            .

         :  (NAME), (SYNOPSIS),  (CONFIGURATION), (DESCRIPTION),  (OPTIONS),
       (EXITSTATUS),     (RETURN VALUE),  (ERRORS),   (ENVIRONMENT),  (FILES),
       (VERSIONS),   (CONFORMING TO), (NOTES),  (BUGS),  (EXAMPLE),  (AUTHORS)
         (SEE ALSO).

             (
               ).

       [-abc]        [ ]
       -a|-b    ,  |,
        ...
       [] ...      [ ]

              . , man, ,      ,
          .

              ,
           .
          ,
         .

       man ls
                () ls.

       man -a intro
                  intro.

       man -t alias | lpr -Pps
               `alias' (
               )     troff groff,          ps. ,
             groff    PostScript.  man --help -t.

       man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
                    nroff ./foo.1x.gz (dvi).   ,     -T
                 .
              , , xdvi    PostScript , , dvips.

       man -k printf

           printf,    .
            .   apropos -r printf.

       man -f smail
             ,   smail
             .   whatis -r smail.

  man
        .    ,  ,
              --
        .

         man $MANOPT,      (
        ). man  $MANOPT ,      .  ,    ,
        .    , $MANOPT,    -D    .
        man ''  ,   $MANOPT,
           .

             man-db
          index.
               whatis (
          )  , man  ,
             .
           -u,  man ,
            whatis.

        man    mandb
        index     ,
            ,
              .  whatis  apropos    index,
              whatis.

                 nroff,
           .Z, .z  .gz.
        ,   ,
        .   ,   cat
          gzip.  '' ,  /usr/share/man  /usr/X11R6/man,
            cat . , cat
               ,   ,
         File Hierarchy Standard (FHS),
          .   ,   , manpath(5).   ,   ,  .

           .
          (,    ) .   , $LC_MESSAGES, $LANG     ( )    ,    ,
         POSIX 1003.1:

       <>[_<>[.<>[,<>]]]

             ,
          (,   ) .

                ,
           .   ,
                 ,
         ,    .

           , ,      .

       man index.    -u,    , ,
         mandb    ,
         .
              ,
           , mandb   ,
           ,       (
         ).

            ,
           `cat'     ,   nroff
          .
              (
           -P).  cat ,  nroff ,  nroff
          .

           cat  (  cat
          ),  man    cat
        .

           . -,
         -p    $MANROFFSEQ.  -p
             ,
           nroff .
         ,

       '\" <>

            ,    -p

             ,

        (nroff  [tg]roff   -t) ( mandb_tfmt   -t)     ,
         .  ,  , , , ,
        -T  -E.

  ,    , $MANOPT
       ,  .      ,
          .

       -C , --config-file=

               ~/.manpath.

       -d, --debug
                .

       -D, --default
                   ,   man
                 .     ,
                     $MANOPT.  ,   -D,    .

       --warnings[=]
                 groff.

               ;    , "mac".        info groff,
               "".

       -f, --whatis
                whatis.  ,   .   whatis(1).

       -k, --apropos
                apropos.
                    .  apropos(1).

       -K, --global-apropos
                   .  ,    ;  ,
                 ,    .
                 ( ),   ,
                --regex.

       -l, --local-file
               '' .  ,        .

               nroff. Cat   .
               '-',        .
                  man     ,
                    ,
                 ,
               .

       -w, --where, --location
                  ,   ()
                nroff,    .

       -W, --where-cat, --location-cat
                  ,   () cat ,    .    , -w  -W,
                   .

       -c, --catman
                   ,
               catman.

       -R , --recode=

                  .
               , manconv(1). ,

              , ,      ,
                .

       -L , --locale=
              man, ,       C- setlocale(3),     , $LC_MESSAGES  $LANG.     ,
                , man. ,
                  .

       -m [,...], --systems=[,...]
                       ,
                      .
                     NewOS,  -m NewOS.

              .  ,    man   .
                  $SYSTEM.

       -M , --manpath=
                manpath  .  ,
               man  manpath,
                  -m.

                 manpath ,   ,      man-db (  "  ").
                ,   -l.

       -S  , -s  , --sections=
                     '  ' (   ).
               $MANSECT. ( -s     System V.)

       -e ., --extension=.
                     ,
               ,     Tcl,
               .
               , , exit(3),   Tcl, ,
                 l.
                (3).  ,     '',   , exit(3tcl). , man  exit(3), exit(3tcl).
               ,    man ., man,        *tcl.

       -i, --ignore-case
                   .   .

       -I, --match-case
                    .

       --regex
                ,   -
                 ,     ,
                apropos(1).  , , ""      ,
               -a.

       --wildcard
                ,   -
                 ,     ,
                 apropos(1) --wildcard.
                   ,
                   , -a.

       --names-only
                 --regex  --wildcard,
                 ,     , whatis(1). ,   .

       -a, --all
               , man
                .    man
                  ,    .

       -u, --update
                 man
                '  inode',  ,
                 .   ,  man
               setuid .

       --no-subpages
               , man ,    ,     ,
                .     ,
                ,
                 ,

                $ man -aw git diff
                /usr/share/man/man1/git-diff.1.gz

                 ,   --no-subpages.

                $ man -aw --no-subpages git diff
                /usr/share/man/man1/git.1.gz
                /usr/share/man/man3/Git.3pm.gz
                /usr/share/man/man1/diff.1.gz

       -P , --pager=
              ,     .  , man
               pager -s.  $MANPAGER ,   , $PAGER.     -f  -k.

                       ,
                  ( ,
                 ).     ;
                ,  -,
                    .

       -r , --prompt=
                     less,  man

               Manual page () line x

                   ,  -- ,
                 x --   .
                 $LESS.

              -r.      $MAN_PN,
                      ,
               `('  `)'. , ,

              \ Manual\ page\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
              byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%..

                       .
                     less(1).
                   .  ,
                   .
                 $,
               less.  , man   -ix8.

                    ,  man,
                 $MANLESS,  .

       -7, --ascii
                     ascii(7) 7-
               latin1(7)  GNU nroff
                .
               ascii   ascii, latin1.  latin1    .
                :
                  GNU nroff  latin1(7).

                                          latin1   ascii
              -------------------------------------------
              continuation hyphen   255     -        -
              bullet (middle dot)   267     o        o
              acute accent          264     '        '
              multiplication sign   327     x        x

                latin1  ,
                  latin1    .
               latin1  ascii ,
               ,  man
                latin1.   latin1 ,
                .

                    -t, -H, -T
               -Z,      nroff,     GNU.

       -E , --encoding=
                  ,
                    nroff, , ascii, latin1  utf8.

       --no-hyphenation, --nh
              , nroff ,    ,
                  .  ;       ,
               .

                        nroff
                   ,    ,
                 nroff; ,    "\%"
                   ,   "\%"   ,
                   .

       --no-justification, --nj
              , nroff      .
                 , ,     "    ".

                        nroff
                 ,    ,
                 nroff; , ".na", ".nf", ".fi",  ".ad"

       -p , --preprocessor=
                    nroff troff/groff.  : eqn (e), grap (g), pic (p), tbl (t),
              vgrind (v), refer (r).
                $MANROFFSEQ. zsoelim
                  .

       -t, --troff
               groff -mandoc
                .       -H, -T
               -Z.

       -T[], --troff-device[=]
                    groff (, , troff)     ,
               dvi, latin1, ps, utf8, X75  X100.

       -H[], --html[=]
                 groff  HTML -,
               -.  ,   $BROWSER, ,    ,
                ,     ( lynx).    -t,     GNU troff.

       -X[dpi], --gxditview[=dpi]
                  groff
               gxditview.  dpi (  )   75, 75-12, 100  100-12;   75;    -12
                  12 .    -T
                X75, X75-12, X100  X100-12 .

       -Z, --ditroff
              groff  troff,
                ,    .  groff -mandoc   groff,     groff
                .  -t.

       -h, --help
                   .

       -V, --version
                 .

       0        .

       1          ,
                 .

       2        .

       3            .

       16          //
                   .

       MANPATH
                  $MANPATH,
                    .

       MANROFFOPT
                 $MANROFFOPT
                ,  man    (nroff, troff  groff).

       MANROFFSEQ
                  $MANROFFSEQ,

               .       .

       MANSECT
                  $MANSECT,
               ,   ,
                ,

       MANPAGER, PAGER
                  $MANPAGER  $PAGER ($MANPAGER  ),
                .  ,  pager -s.

                       ,
                  ( ,
                 ).     ;
                ,  -,
                    .

       MANLESS
                  $MANLESS,  man

               less.  ,  $MANLESS
                 $LESS. ,
                 "my prompt string",   $MANLESS
               '-Psmy prompt string'.

       BROWSER
                  $BROWSER,
                 ,  ;
                  -  man --html.
               %s   ,  HTML groff, %%     (%),  %c
               (:).

       SYSTEM     $SYSTEM
               -m.

       MANOPT     $MANOPT,
                 man
                  ,    $MANOPT ,
                  .     , ,      ,  .

       MANWIDTH
                  $MANWIDTH,
                     .
                ,
                 (  ioctl(2),   ,
                $COLUMNS  80 , ). Cat      ,
                 ,
                   66  80 .

       MAN_KEEP_FORMATTING
              ,       (,    ),

                . , $MAN_KEEP_FORMATTING    ,
               .  man,    .

       MAN_KEEP_STDERR
              ,      (,  ),
                ,
               ,
                ,
                  . ,
                   ,  ,
               $MAN_KEEP_STDERR   ,
                .

       LANG, LC_MESSAGES
                   ,     $LANG $LC_MESSAGES
                ).    setlocale(3).

       /etc/manpath.config
                man-db.

       /usr/share/man
                 .

       /usr/share/man/index.(bt|db|dir|pag)
                   index.

       /var/cache/man/index.(bt|db|dir|pag)
               FHS     index.

       mandb(8), manpath(1),  manpath(5),  apropos(1),  whatis(1),  catman(8),
       less(1),   nroff(1),   troff(1),  groff(1),  zsoelim(1),  setlocale(3),
       man(7), ascii(7), latin1(7),     man-db, FSSTND.

1990, 1991: . (John W. Eaton,

       jwe@che.utexas.edu).

       23  1992:   (Rik Faith, faith@cs.unc.edu)  ,
          (Willem Kasdorp, wkasdo@nikhefk.nikef.nl).

       30  1994 -- 23  2000:  (Wilf., G.Wilford@ee.surrey.ac.uk)
                .

       30  1996 -- 30  2001:   (Fabrizio Polacco, <fpolacco@debian.org> Debian
       .

       31  2001 --  :   (Colin Watson, <cjwatson@debian.org> man-db.