-.TH MAN 1 ""
-.UC 4
-.SH NAME
-man \- print out the manual
-.SH SYNOPSIS
-.br
-.B man
-[
-.B \-
-] [
-.B \-M
-.I path
-] [
-section
-]
-title ...
-.SH DESCRIPTION
-\fIMan\fP is the program which provides on-line access to the UNIX manual.
-If a \fIsection\fP specifier is given, \fIman\fP looks in that section of
-the manual for the given \fItitle\fP(s). \fISection\fP is either an Arabic
-section number (``3'' for example), or one of the words ``local'', ``new,''
-or ``old''. (The abbreviations ``l'', ``n'', and ``o'' are also allowed.)
-If \fIsection\fP is omitted, \fIman\fP searches all sections of the manual,
-giving preference to commands over library subroutines, and displays the
-first manual page it finds, if any.
-.PP
-Normally \fIman\fP checks in standard locations (/usr/man and /usr/local/man)
-for manual information. This can be changed by supplying a search path (a
-la the Bourne shell) with the \fB-M\fP flag. The search path is a colon
-(``:'') separated list of directories in which \fIman\fP expects to find
-the standard manual subdirectories. This search path can also be set with
-the environmental variable \fIMANPATH\fP.
-.PP
-Since some manual pages are intended for use only on certain machines,
-\fIman\fP only searches those directories applicable to the current
-machine. \fIMan\fP's determination of the current machine type can
-be overridden by setting the environmental variable \fIMACHINE\fP.
-.PP
-If the standard output is a teletype, and the \fB-\fP flag is not provided,
-\fIman\fP uses \fImore\fP(1), or the pager provided by the environmental
-variable \fIPAGER\fP, to display the manual page.
-.PP
-The FORTRAN version of section 3 of the manual may be specified by supplying
-\fIman\fP with the \fIsection\fP ``3f''. Also, a specific section of the
-local manual may be specified by appending a number to the \fIsection\fP,
-i.e. ``l5'' would indicate section 5 of the local manual.
-.SH FILES
-.nf
-.ta \w'/usr/local/man/man?/* 'u
-/usr/man standard manual area
-/usr/man/cat?/* directories containing standard manual pages
-/usr/local/man/cat?/* directories containing local manual pages
-/usr/src/man directories containing unformatted manual pages
-.fi
-.SH SEE\ ALSO
-apropos(1), more(1), whatis(1), whereis(1)
-.SH BUGS
-The manual is supposed to be reproducible either on the
-phototypesetter or on a typewriter, however, on a typewriter,
-some information is necessarily lost.
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" @(#)man.1 8.2 (Berkeley) 1/2/94
+.\"
+.Dd January 2, 1994
+.Dt MAN 1
+.Os BSD 4
+.Sh NAME
+.Nm man
+.Nd display the on-line manual pages
+.Sh SYNOPSIS
+.Nm man
+.Op Fl achw
+.Op Fl C Ar file
+.Op Fl M Ar path
+.Op Fl m Ar path
+.Op Ar section
+.Ar name Ar ...
+.Sh DESCRIPTION
+The
+.Nm man
+utility
+displays the
+.Bx
+manual pages entitled
+.Ar name .
+.Pp
+The options are as follows:
+.Bl -tag -width indent
+.It Fl a
+Display all of the manual pages for a specified
+.Ar section
+and
+.Ar name
+combination.
+(Normally, only the first manual page found is displayed.)
+.It Fl C
+Use the specified
+.Ar file
+instead of the default configuration file.
+This permits users to configure their own manual environment.
+See
+.Xr man.conf 5
+for a description of the contents of this file.
+.It Fl c
+Copy the manual page to the standard output instead of using
+.Xr more 1
+to paginate it.
+This is done by default if the standard output is not a terminal device.
+.It Fl h
+Display only the
+.Dq Tn SYNOPSIS
+lines of the requested manual pages.
+.It Fl M
+Override the list of standard directories which
+.Nm man
+searches for manual pages.
+The supplied
+.Ar path
+must be a colon (``:'') separated list of directories.
+This search path may also be set using the environment variable
+.Ev MANPATH .
+The subdirectories to be searched, and their search order,
+is specified by the ``_subdir'' line in the
+.Nm man
+configuration file.
+.It Fl m
+Augment the list of standard directories which
+.Nm man
+searches for manual pages.
+The supplied
+.Ar path
+must be a colon (``:'') separated list of directories.
+These directories will be searched before the standard directories or
+the directories specified using the
+.Fl M
+option or the
+.Ev MANPATH
+environment variable.
+The subdirectories to be searched, and their search order,
+is specified by the ``_subdir'' line in the
+.Nm man
+configuration file.
+.It Fl w
+List the pathnames of the manual pages which
+.Nm man
+would display for the specified
+.Ar section
+and
+.Ar name
+combination.
+.El
+.Pp
+The optional
+.Ar section
+argument restricts the directories that
+.Nm man
+will search.
+The
+.Nm man
+configuration file (see
+.Xr man.conf 5 )
+specifies the possible
+.Ar section
+values that are currently available.
+If only a single argument is specified or if the first argument is
+not a valid section,
+.Nm man
+assumes that the argument is the name of a manual page to be displayed.
+.Sh ENVIRONMENT
+.Bl -tag -width MANPATHX
+.It Ev MACHINE
+As some manual pages are intended only for specific architectures,
+.Nm man
+searches any subdirectories,
+with the same name as the current architecture,
+in every directory which it searches.
+Machine specific areas are checked before general areas.
+The current machine type may be overridden by setting the environment
+variable
+.Ev MACHINE
+to the name of a specific architecture.
+.It Ev MANPATH
+The standard search path used by
+.Nm man
+may be overridden by specifying a path in the
+.Ev MANPATH
+environment
+variable.
+The format of the path is a colon (``:'') separated list of directories.
+The subdirectories to be searched as well as their search order
+is specified by the ``_subdir'' line in the
+.Nm man
+configuration file.
+.It Ev PAGER
+Any value of the environment variable
+.Ev PAGER
+will be used instead of the standard pagination program,
+.Xr more 1 .
+.El
+.Sh FILES
+.Bl -tag -width /etc/man.conf -compact
+.It Pa /etc/man.conf
+default man configuration file.
+.El
+.Sh SEE ALSO
+.Xr apropos 1 ,
+.Xr whatis 1 ,
+.Xr whereis 1 ,
+.Xr man.conf 5
+.Sh BUGS
+The on-line manual pages are, by necessity, forgiving toward stupid
+display devices, causing a few manual pages to not as nicely formatted
+as their typeset counterparts.
+.Sh HISTORY
+A
+.Nm
+command appeared in
+.At v6 .
projects / unix-history / blobdiff