NAME

psman − display reference manual pages; find reference pages by keyword

SYNOPSIS

psman [−M path] [section] title
psman [−M path] −k keyword ...

DESCRIPTION

psman displays information from the reference manuals.  It can display complete manual pages that you select by title. It can display one-line summaries selected by -k keyword. 

When −k is not specified, psman formats a specified manual page by title. A section, when given, applies to the title that follows it on the command line.  psman looks in the indicated section of the manual for the title. section should be a digit.  If section is omitted, psman searches all reference sections (giving preference to commands over functions) and prints the first manual page it finds.  If no manual page is located, psman prints an error message. 

The following line instructs psman to look in section 8 of the reference manual for the ypwhich(8) manual page:

example%  psman 8 ypwhich

If the server is not available psman formats for a teletype and pipes its output through more(1).  Otherwise, psman formats for a POSTSCRIPT printer and pipes its output through pageview(1).  To see the manual page for pageview, use:

example% psman pageview

OPTIONS

−M path
Change the search path for manual pages. path is a colon-separated list of directories that contain manual page directory subtrees.  For example, /usr/share/man:/home/openwin/usr/share/man makes psman search in the standard OpenWindows location.  When used with the −k option, the −M option must appear first.  Each directory in the path is assumed to contain subdirectories of the form man[1-8l-p]. 

−k keyword ...
psman prints out one-line summaries from the whatis database (table of contents) that contain any of the given keywords. 

ENVIRONMENT

MANPATH If set, its value overrides /usr/man:$OPENWINHOME/man as the default search path. 

TROFF If set, its value overrides ditroff -t -man as the default command to convert troff to ditroff. 

TCAT If set, its value overrides psdit as the default command to convert ditroff to POSTSCRIPT. 

SEE ALSO

pageview(1), cat(1V), col(1V), eqn(1), more(1), nroff(1), tbl(1), troff(1), whatis(1), man(7), catman(8)

Sun Release 4.0  —  Last change: 15 June 1989