.\" @(#)psman.1 9.2 88/01/19
.TH PSMAN 1 "11 July 1986"
.SH NAME
psman \- display reference manual pages; find reference pages by keyword
.SH SYNOPSIS
.B psman
.RI "[\|" section "\|] " title
.br
.B psman
.BI \-k " keyword"
.br
.SH DESCRIPTION
.IX psman "" "\fLman\fR \(em online display of reference pages using NeWS"
.IX "online reference using NeWS \(em \fLman\fR"
.I 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
.I keyword
.RB ( \-k ).
.PP
When
.B \-k
is not specified,
.I 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.
.I psman
looks in the indicated section of the manual for the
.IR title .
.I section
should be a digit.
If
.I section
is omitted,
.I 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,
.I psman
prints an error message.
.PP
The following line instructs 
.I psman
to look in section 8 of the reference manual
for the 
.B ypwhich(8)
manual page:
.sp
.ti +5
\fBbabylon%  \fHpsman 8 ypwhich\fR
.sp
.PP
If the NeWS server is not available
.I psman
formats for a teletype and pipes its output through
.IR more (1).
Otherwise,
.I psman
formats for a typesetter and
pipes its output through
.IR psview (1).
.#
.SH OPTIONS
.TP
.BI \-k " keyword .\|.\|."
.I psman
prints out one-line summaries from the
.I whatis
database (table of contents) that contain any of the given
.IR keyword s.
.#
.SH ENVIRONMENT
.PD 0
.TP \w'\s-1MANPATH\s0'u+(3n)u
.SM
MANPATH
If set,
its value overrides
.I /usr/man:$NEWSHOME/man
as the default search path.
.sp
.SH "SEE ALSO"
'\"apropos(1),	\" What happened to this man page?
cat(1V),
col(1V),
eqn(1),
more(1),
nroff(1),
tbl(1),
troff(1),
whatis(1),
man(7),
catman(8)