'\"macro stdmacro
.if n .pH g1.psman @(#)psman	40.2 of 12/29/89
.\" @(#)psman.1 9.14 89/07/11
.nr X
.if \nX=0 .ds x} PSMAN 1 "15 June 1989" "\&"
.if \nX=1 .ds x} PSMAN 1 "15 June 1989"
.if \nX=2 .ds x} PSMAN 1 "" "\&"
.if \nX=3 .ds x} PSMAN "" "" "\&"
.TH \*(x}
.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
.ds Sd \s-2Ne\h'-0.2n'WS\s+2
.ds Xn \s-2X11/N\s+2e\h'-0.2n'\s-2WS\s+2
.ds Pm \*(Sd Programmer's Guide
.IX psman#(1) "" "\fLpsman\fP(1)"
.SH NAME
psman \- display reference manual pages; find reference pages by keyword
.SH SYNOPSIS
.B psman
.RB "[\|" \-M
.IR path "\|]"
.RI "[\|" section "\|] " title
.br
.B psman
.RB "[\|" \-M
.IR path "\|]"
.BI \-k " keyword \|.\|.\|."
.br
.SH DESCRIPTION
.B psman
displays information from the reference manuals.
It can display complete manual pages that you select by
.IR title .
It can display one-line summaries selected by
\fB-k\fP \fIkeyword\fP.
.PP
When
.B \-k
is not specified,
.B psman
formats a specified manual page by
.IR title .
A
.IR section ,
when given,
applies to the
.I title
that follows it on the command line.
.B psman
looks in the indicated section of the manual for the
.IR title .
.I section
should be a digit.
If
.I section
is omitted,
.B 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,
.B psman
prints an error message.
.PP
The following line instructs \fBpsman\fP to look in section 8 of the
reference manual for the \fBypwhich\fP(8) manual page:
.sp
.ti +5
\fBexample%  psman 8 ypwhich\fP
.sp
.PP
If the server is not available
.B psman
formats for a teletype and pipes its output through \fBmore\fP(1).
Otherwise, \fBpsman\fP formats for a \*(Ps printer and pipes its output
through \fBpageview\fP(1).
To see the manual page for \fBpageview\fP, use:
.sp
.ti +5
\fBexample% psman pageview\fP
.sp
.PP
.SH OPTIONS
.TP
.BI \-M " path"
Change the search path for manual pages.
.I path
is a colon-separated list of directories that contain manual page
directory subtrees.
For example,
.B /usr/share/man:/home/openwin/usr/share/man
makes
.B psman
search in the standard OpenWindows location.  When used with the
.B \-k
option,
the
.B \-M
option must appear first.  Each directory in the
.I path
is assumed to contain subdirectories of the form
.BR man[1-8l-p] .
.TP
\fB \-k\fP \fIkeyword\fP \|.\|.\|.
.B psman
prints out one-line summaries from the
.B whatis
database (table of contents) that contain any of the given
\fIkeyword\fPs.
.SH ENVIRONMENT
.PD 0
.TP \w'\s-1MANPATH\s0'u+(3n)u
.SM
\fBMANPATH\fP
If set, its value overrides
.B /usr/man:\s-1$OPENWINHOME\s+1/man
as the default search path.
.sp
.TP \w'\s-1MANPATH\s0'u+(3n)u
.SM
\fBTROFF\fP
If set,
its value overrides
\fBditroff -t -man\fP
as the default command to convert troff to ditroff.
.sp
.TP \w'\s-1MANPATH\s0'u+(3n)u
.SM
\fBTCAT\fP
If set,
its value overrides
.B psdit
as the default command to convert ditroff to \*(Ps.
.sp
.SH "SEE ALSO"
\fBpageview\fP(1),
\fBcat\fP(1V),
\fBcol\fP(1V),
\fBeqn\fP(1),
\fBmore\fP(1),
\fBnroff\fP(1),
\fBtbl\fP(1),
\fBtroff\fP(1),
\fBwhatis\fP(1),
\fBman\fP(7),
\fBcatman\fP(8)
