NAME

man, wm/man, man2txt, lookman − print or find manual pages

SYNOPSIS

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

DESCRIPTION

Both ­man and wm/man locate entries in this manual and display them.  The pages for entries named ­title within each specified section are displayed.  If no sections are specified, matching pages from all sections are printed.  Sections are given by number. 

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 section, 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
­/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. 

Plan 9  —  July 10, 2000