SCCS-vsn: usr.bin/man/man.1 6.1
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)man.1 5.1 (Berkeley) %G%
+.\" @(#)man.1 6.1 (Berkeley) %G%
-.TH MAN 1 "18 January 1983"
.UC 4
.SH NAME
man \- find manual information by keywords; print out the manual
.SH SYNOPSIS
.br
.B man
.UC 4
.SH NAME
man \- find manual information by keywords; print out the manual
.SH SYNOPSIS
.br
.B man
-.B \-k
-keyword ...
-.br
-.B man
-.B \-f
-file ...
-.br
-.B man
+.br
+.B man
+.B \-k
+keyword ...
+.br
+.B man
+.B \-f
+file ...
.SH DESCRIPTION
.I Man
is a program which gives information from the programmers manual.
.SH DESCRIPTION
.I Man
is a program which gives information from the programmers manual.
and a set of keywords,
.I man
prints out a one line synopsis of each manual sections whose
and a set of keywords,
.I man
prints out a one line synopsis of each manual sections whose
-listing in the table of contents contains that keyword.
+listing in the table of contents contains one of those keywords.
.PP
When given the option
.B \-f
.PP
When given the option
.B \-f
looks in the that section of the manual for the given
.I titles.
.I Section
looks in the that section of the manual for the given
.I titles.
.I Section
-is an Arabic section number (3 for instance). The number may followed by
-a single letter classifier (1g for instance)
-indicating a graphics program in section 1. If
+is either
+an Arabic section number (3 for instance), or one of the words ``new,''
+``local,'' ``old,'' or ``public.''
+A section number may followed by
+a single letter classifier (for instance, 1g,
+indicating a graphics program in section 1). If
.I section
is omitted,
.I man
.I section
is omitted,
.I man
is given,
.I man
pipes its output through
is given,
.I man
pipes its output through
-to crush out useless blank lines,
-.IR ul (1)
-to create proper underlines for different terminals, and through
-.IR more (1)
-to stop after each page on the screen.
+to crush out useless blank lines
+and to stop after each page on the screen.
Hit a space to continue,
a control-D to scroll 11 more lines when the output stops.
.PP
Hit a space to continue,
a control-D to scroll 11 more lines when the output stops.
.PP
.I troff'ed
to a suitable raster output device; see
.IR vtroff (1).
.I troff'ed
to a suitable raster output device; see
.IR vtroff (1).
+.PP
+Normally
+.I man
+checks in a standard location for manual
+information (/usr/man). This can be changed by supplying a search
+path (a la the shell) with the
+.B \-M
+flag. The search path is a colon (`:') separated list
+of directories in which manual subdirectories may be found;
+e.g. ``/usr/local:/usr/man''. If a search path is supplied
+with the
+.B \-k
+or
+.B \-f
+options, it must be specified first.
-/usr/man/man?/*
-.br
-/usr/man/cat?/*
+.nf
+.ta \w'/usr/man/man?/* 'u
+/usr/man standard manual area
+/usr/man/man?/* directories containing source for manuals
+/usr/man/cat?/* directories containing preformatted pages
+/usr/man/whatis keyword database
+.fi
-more(1), ul(1), whereis(1), catman(8)
+apropos(1), more(1), whereis(1), catman(8)
.SH BUGS
The manual is supposed to be reproducible either on the phototypesetter
or on a typewriter.
.SH BUGS
The manual is supposed to be reproducible either on the phototypesetter
or on a typewriter.