[unix-history] / usr / man / cat1 / man.0



MAN(1)		    UNIX Programmer's Manual		   MAN(1)


N\bNA\bAM\bME\bE
     man - print out the manual

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     m\bma\ban\bn [ -\b- ] [ -\b-a\ba ] [ -\b-M\bM _\bp_\ba_\bt_\bh ] [ section ] title ...

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bM_\ba_\bn is the program which provides on-line access to the UNIX
     manual.  If a _\bs_\be_\bc_\bt_\bi_\bo_\bn specifier is given, _\bm_\ba_\bn looks in that
     section of the manual for the given _\bt_\bi_\bt_\bl_\be(s).  _\bS_\be_\bc_\bt_\bi_\bo_\bn is
     either an Arabic section number (``3'' for example), or one
     of the words ``local'', ``new,'' or ``old''.  (The abbrevia-
     tions ``l'', ``n'', and ``o'' are also allowed.) If _\bs_\be_\bc_\bt_\bi_\bo_\bn
     is omitted, _\bm_\ba_\bn searches all sections of the manual, giving
     preference to commands over library subroutines, and
     displays the first manual page it finds, if any.  If the -_\ba
     option is supplied, _\bm_\ba_\bn displays all applicable manual
     pages.

     Normally _\bm_\ba_\bn 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
     -\b-M\bM flag.  The search path is a colon (``:'') separated list
     of directories in which _\bm_\ba_\bn expects to find the standard
     manual subdirectories.  This search path can also be set
     with the environmental variable _\bM_\bA_\bN_\bP_\bA_\bT_\bH.

     Since some manual pages are intended for use only on certain
     machines, _\bm_\ba_\bn only searches those directories applicable to
     the current machine.  _\bM_\ba_\bn's determination of the current
     machine type can be overridden by setting the environmental
     variable _\bM_\bA_\bC_\bH_\bI_\bN_\bE.

     If the standard output is a teletype, and the -\b- flag is not
     provided, _\bm_\ba_\bn uses _\bm_\bo_\br_\be(1), or the pager provided by the
     environmental variable _\bP_\bA_\bG_\bE_\bR, to display the manual page.

     The FORTRAN version of section 3 of the manual may be speci-
     fied by supplying _\bm_\ba_\bn with the _\bs_\be_\bc_\bt_\bi_\bo_\bn ``3f''.  Also, a
     specific section of the local manual may be specified by
     appending a number to the _\bs_\be_\bc_\bt_\bi_\bo_\bn, i.e. ``l5'' would indi-
     cate section 5 of the local manual.

F\bFI\bIL\bLE\bES\bS
     /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

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     apropos(1), more(1), whatis(1), whereis(1)


Printed 7/9/88		 April 19, 1988                         1


MAN(1)		    UNIX Programmer's Manual		   MAN(1)


B\bBU\bUG\bGS\bS
     The manual is supposed to be reproducible either on the pho-
     totypesetter or on a typewriter, however, on a typewriter,
     some information is necessarily lost.


Printed 7/9/88		 April 19, 1988                         2
Commit	Line	Data
362b077f C	1
	2
	3
	4	MAN(1) UNIX Programmer's Manual MAN(1)
	5
	6
	7
	8	N\bNA\bAM\bME\bE
	9	man - print out the manual
	10
	11	S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
	12	m\bma\ban\bn [ -\b- ] [ -\b-a\ba ] [ -\b-M\bM _\bp_\ba_\bt_\bh ] [ section ] title ...
	13
	14	D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
	15	_\bM_\ba_\bn is the program which provides on-line access to the UNIX
	16	manual. If a _\bs_\be_\bc_\bt_\bi_\bo_\bn specifier is given, _\bm_\ba_\bn looks in that
	17	section of the manual for the given _\bt_\bi_\bt_\bl_\be(s). _\bS_\be_\bc_\bt_\bi_\bo_\bn is
	18	either an Arabic section number (``3'' for example), or one
	19	of the words ``local'', ``new,'' or ``old''. (The abbrevia-
	20	tions ``l'', ``n'', and ``o'' are also allowed.) If _\bs_\be_\bc_\bt_\bi_\bo_\bn
	21	is omitted, _\bm_\ba_\bn searches all sections of the manual, giving
	22	preference to commands over library subroutines, and
	23	displays the first manual page it finds, if any. If the -_\ba
	24	option is supplied, _\bm_\ba_\bn displays all applicable manual
	25	pages.
	26
	27	Normally _\bm_\ba_\bn checks in standard locations (/usr/man and
	28	/usr/local/man) for manual information. This can be changed
	29	by supplying a search path (a la the Bourne shell) with the
	30	-\b-M\bM flag. The search path is a colon (``:'') separated list
	31	of directories in which _\bm_\ba_\bn expects to find the standard
	32	manual subdirectories. This search path can also be set
	33	with the environmental variable _\bM_\bA_\bN_\bP_\bA_\bT_\bH.
	34
	35	Since some manual pages are intended for use only on certain
	36	machines, _\bm_\ba_\bn only searches those directories applicable to
	37	the current machine. _\bM_\ba_\bn's determination of the current
	38	machine type can be overridden by setting the environmental
	39	variable _\bM_\bA_\bC_\bH_\bI_\bN_\bE.
	40
	41	If the standard output is a teletype, and the -\b- flag is not
	42	provided, _\bm_\ba_\bn uses _\bm_\bo_\br_\be(1), or the pager provided by the
	43	environmental variable _\bP_\bA_\bG_\bE_\bR, to display the manual page.
	44
	45	The FORTRAN version of section 3 of the manual may be speci-
	46	fied by supplying _\bm_\ba_\bn with the _\bs_\be_\bc_\bt_\bi_\bo_\bn ``3f''. Also, a
	47	specific section of the local manual may be specified by
	48	appending a number to the _\bs_\be_\bc_\bt_\bi_\bo_\bn, i.e. ``l5'' would indi-
	49	cate section 5 of the local manual.
	50
	51	F\bFI\bIL\bLE\bES\bS
	52	/usr/man standard manual area
	53	/usr/man/cat?/* directories containing standard manual pages
	54	/usr/local/man/cat?/* directories containing local manual pages
	55	/usr/src/man directories containing unformatted manual pages
	56
	57	S\bSE\bEE\bE A\bAL\bLS\bSO\bO
	58	apropos(1), more(1), whatis(1), whereis(1)
	59
	60
	61
	62
	63	Printed 7/9/88 April 19, 1988 1
	64
65
66
67
68
69
70	MAN(1) UNIX Programmer's Manual MAN(1)
71
72
73
74	B\bBU\bUG\bGS\bS
75	The manual is supposed to be reproducible either on the pho-
76	totypesetter or on a typewriter, however, on a typewriter,
77	some information is necessarily lost.
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129	Printed 7/9/88 April 19, 1988 2
130
131
132