MAN(1)                                                     MAN(1)

     NAME
          man, wm/man, man2txt, lookman - print or find manual pages

     SYNOPSIS
          man [ section ... ] title ...
          man -f file ...
          wm/man [ section ... ] title ...
          wm/man -f file ...
          man2txt [ -p width ] [ file ... ]
          lookman keyword ...

     DESCRIPTION
          Both man and wm/man locate entries in this manual and dis-
          play them.  The pages for entries named title within each
          specified section are displayed.  If no sections are speci-
          fied, matching pages from all sections are printed.  Sec-
          tions are given by number.

          The -f option to man and wm/man prevent lookup in the manual
          index.  Instead, the remaining arguments are treated as
          filenames.  Man processes each file in turn.  Wm/man adds
          each file to its page history and displays the first docu-
          ment in the list.

          The man command prints the manual pages as formatted plain
          text to standard output.  Manual pages are written using
          Plan9 troff -man macros for their markup and so some detail
          is lost in conversion to plain text.  Wm/man displays the
          pages in a graphical Wm window, providing a more faithful
          reproduction of the intended layout.

          Man2txt converts troff -man macro markup to plain text.
          Each file is processed separately.  If no arguments are
          given, text from standard input is processed.  The converted
          text is written to standard output.  The -p option to
          man2txt specifies the page width in characters.

          Lookman prints the file names of manual pages, from any sec-
          tion, that contain all of the keywords given as arguments.

     FILES
          /man/?/*      Source files of manual pages.
          /man/1/man    The source file for this manual page.
          /man/?/INDEX  Used by man and wm/man to locate the source
                        file containing a particular title.
          /man/index    The lookman index.

     SOURCE
          /appl/wm/man.b
          /appl/cmd/man.b

     Page 1                       Plan 9             (printed 3/29/24)

     MAN(1)                                                     MAN(1)

          /appl/cmd/man2txt.b
          /appl/cmd/lookman.b
          /appl/lib/parseman.b

     SEE ALSO
          wm(1)

     BUGS
          Man2txt only knows about troff -man macros.  Other troff
          macro packages or output from preprocessors such as pic or
          tbl will not be presented correctly.

          Wm/man seldom shows dimples to guys that have pimples.

     Page 2                       Plan 9             (printed 3/29/24)