|
|
1.1 root 1: .\" Copyright (c) 1980 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)man.1 6.7 (Berkeley) 4/19/88
6: .\"
7: .TH MAN 1 "April 19, 1988"
8: .UC 4
9: .SH NAME
10: man \- print out the manual
11: .SH SYNOPSIS
12: .br
13: .B man
14: [
15: .B \-
16: ] [
17: .B -a
18: ] [
19: .B \-M
20: .I path
21: ] [
22: section
23: ]
24: title ...
25: .SH DESCRIPTION
26: \fIMan\fP is the program which provides on-line access to the UNIX manual.
27: If a \fIsection\fP specifier is given, \fIman\fP looks in that section of
28: the manual for the given \fItitle\fP(s). \fISection\fP is either an Arabic
29: section number (``3'' for example), or one of the words ``local'', ``new,''
30: or ``old''. (The abbreviations ``l'', ``n'', and ``o'' are also allowed.)
31: If \fIsection\fP is omitted, \fIman\fP searches all sections of the manual,
32: giving preference to commands over library subroutines, and displays the
33: first manual page it finds, if any. If the \fI-a\fP option is supplied,
34: \fIman\fP displays all applicable manual pages.
35: .PP
36: Normally \fIman\fP checks in standard locations (/usr/man and /usr/local/man)
37: for manual information. This can be changed by supplying a search path (a
38: la the Bourne shell) with the \fB-M\fP flag. The search path is a colon
39: (``:'') separated list of directories in which \fIman\fP expects to find
40: the standard manual subdirectories. This search path can also be set with
41: the environmental variable \fIMANPATH\fP.
42: .PP
43: Since some manual pages are intended for use only on certain machines,
44: \fIman\fP only searches those directories applicable to the current
45: machine. \fIMan\fP's determination of the current machine type can
46: be overridden by setting the environmental variable \fIMACHINE\fP.
47: .PP
48: If the standard output is a teletype, and the \fB-\fP flag is not provided,
49: \fIman\fP uses \fImore\fP(1), or the pager provided by the environmental
50: variable \fIPAGER\fP, to display the manual page.
51: .PP
52: The FORTRAN version of section 3 of the manual may be specified by supplying
53: \fIman\fP with the \fIsection\fP ``3f''. Also, a specific section of the
54: local manual may be specified by appending a number to the \fIsection\fP,
55: i.e. ``l5'' would indicate section 5 of the local manual.
56: .SH FILES
57: .nf
58: .ta \w'/usr/local/man/man?/* 'u
59: /usr/man standard manual area
60: /usr/man/cat?/* directories containing standard manual pages
61: /usr/local/man/cat?/* directories containing local manual pages
62: /usr/src/man directories containing unformatted manual pages
63: .fi
64: .SH SEE\ ALSO
65: apropos(1), more(1), whatis(1), whereis(1)
66: .SH BUGS
67: The manual is supposed to be reproducible either on the
68: phototypesetter or on a typewriter, however, on a typewriter,
69: some information is necessarily lost.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.