output of "man -t man > /tmp/groffbug"

groffbug (text/plain), 24.53 KB, created by splite on 2003-08-02 15:53:21 UTC

%!PS-Adobe-3.0
%%Creator: groff version 1.18.1
%%CreationDate: Sat Aug  2 17:31:18 2003
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.18 1
%%Pages: 5
%%PageOrder: Ascend
%%Orientation: Portrait
%%EndComments
%%BeginProlog
%%BeginResource: procset grops 1.18 1
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}bind def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/Fr{
setrgbcolor fill
}bind def
/Fk{
setcmykcolor fill
}bind def
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/Ck/setcmykcolor load def
/Cg/setgray load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
}bind def
/PEND{
clear
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron
/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE
/Times-Roman@0 ENC0/Times-Roman RE
%%EndProlog
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(1)535 768 Q 0 Cg EP
%%Page: 1 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 407.74(man\(1\) man\(1\))72 48 R/F1 10.95
/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F0
(man \255 format and display the on-line manual pages)108 96 Q
(manpath \255 determine user')108 108 Q 2.5(ss)-.55 G
(earch path for man pages)-2.5 E F1(SYNOPSIS)72 124.8 Q/F2 10
/Times-Bold@0 SF(man)108 136.8 Q F0([)3.394 E F2(\255acdfFhkKtwW)A F0
3.393(][)C F2(--path)-3.393 E F0 3.393(][)C F2<ad6d>-3.393 E/F3 10
/Times-Italic@0 SF(system)3.393 E F0 3.393(][).32 G F2<ad70>-3.393 E F3
(string)3.393 E F0 3.393(][).22 G F2<ad43>-3.393 E F3(con\214g_\214le)
3.393 E F0 3.393(][).18 G F2<ad4d>-3.393 E F3(pathlist)3.393 E F0 3.393
(][).68 G F2<ad50>-3.393 E F3(pa)3.393 E -.1(ge)-.1 G(r).1 E F0 3.393
(][).73 G F2<ad53>-3.393 E F3(section_list)108 148.8 Q F0 2.5(][).68 G
F3(section)-2.16 E F0(]).24 E F3(name ...)2.86 E F1(DESCRIPTION)72 177.6
Q F2(man)108 189.6 Q F0 .236
(formats and displays the on-line manual pages.)2.736 F .236
(If you specify)5.236 F F3(section)2.737 E F0(,).24 E F2(man)2.737 E F0
.237(only looks in that section)2.737 F .242(of the manual.)108 201.6 R
F3(name)5.601 E F0 .241(is normally the name of the manual page, which \
is typically the name of a command,)2.921 F .368(function, or \214le.)
108 213.6 R(Ho)5.369 E(we)-.25 E -.15(ve)-.25 G 1.169 -.4(r, i).15 H(f)
.4 E F3(name)3.229 E F0 .369(contains a slash \()3.049 F F2(/)A F0 2.869
(\)t)C(hen)-2.869 E F2(man)2.869 E F0 .369
(interprets it as a \214le speci\214cation, so that)2.869 F(you can do)
108 225.6 Q F2(man ./f)2.5 E(oo.5)-.25 E F0(or e)2.5 E -.15(ve)-.25 G(n)
.15 E F2(man /cd/f)2.5 E(oo/bar)-.25 E(.1.gz)-1 E F0(.)A(See belo)108
242.4 Q 2.5(wf)-.25 G(or a description of where)-2.5 E F2(man)2.5 E F0
(looks for the manual page \214les.)2.5 E F1(OPTIONS)72 271.2 Q F2 .834
.833(\255C c)108 283.2 T(on\214g_\214le)-.833 E F0
(Specify the con\214guration \214le to use; the def)144 295.2 Q(ault is)
-.1 E F2(/etc/man.conf)2.5 E F0 5(.\()C(See)-5 E F2(man.conf)2.5 E F0
(\(5\).\))A F2 .834 .833(\255M p)108 312 T(ath)-.833 E F0 .868
(Specify the list of directories to search for man pages.)144 324 R .868
(Separate the directories with colons.)5.868 F(An)5.868 E 2.266
(empty list is the same as not specifying)144 336 R F2<ad4d>4.767 E F0
2.267(at all.)4.767 F(See)7.267 E F2 2.267(SEARCH P)4.767 F -.95(AT)-.74
G 4.767(HF).95 G 2.267(OR MANU)-4.767 F(AL)-.6 E -1.57 -.74(PA G)144 348
T(ES).74 E F0(.)A F2 .834 .833(\255P p)108 364.8 T(ager)-.833 E F0 .299
(Specify which pager to use.)144 376.8 R .298(This option o)5.298 F -.15
(ve)-.15 G .298(rrides the).15 F F2(MANP)2.798 E -.55(AG)-.74 G(ER).55 E
F0(en)2.798 E .298(vironment v)-.4 F .298(ariable, which)-.25 F
(in turn o)144 388.8 Q -.15(ve)-.15 G(rrides the).15 E F2 -1.57 -.74
(PA G)2.5 H(ER).74 E F0 -.25(va)2.5 G 2.5(riable. By).25 F(def)2.5 E
(ault,)-.1 E F2(man)2.5 E F0(uses)2.5 E F2(/usr/bin/less -is)2.5 E F0(.)
A F2 .834 .833(\255S s)108 405.6 T(ection_list)-.833 E F0 .589
(List is a colon separated list of manual sections to search.)144 417.6
R .59(This option o)5.59 F -.15(ve)-.15 G .59(rrides the).15 F F2
(MANSECT)3.09 E F0(en)144 429.6 Q(vironment v)-.4 E(ariable.)-.25 E F2
.833<ad61>108 446.4 S F0 .652(By def)23.634 F(ault,)-.1 E F2(man)3.152 E
F0 .652(will e)3.152 F .652
(xit after displaying the \214rst manual page it \214nds.)-.15 F .651
(Using this option forces)5.652 F F2(man)144 458.4 Q F0
(to display all the manual pages that match)2.5 E F2(name,)2.5 E F0
(not just the \214rst.)2.5 E F2 .833<ad63>108 475.2 S F0 .554
(Reformat the source man page, e)24.194 F -.15(ve)-.25 G 3.054(nw).15 G
.554(hen an up-to-date cat page e)-3.054 F 3.054(xists. This)-.15 F .554
(can be meaningful)3.054 F .282(if the cat page w)144 487.2 R .282
(as formatted for a screen with a dif)-.1 F .281
(ferent number of columns, or if the preformat-)-.25 F
(ted page is corrupted.)144 499.2 Q F2 .833<ad64>108 516 S F0(Don')
23.074 E 2.5(ta)-.18 G(ctually display the man pages, b)-2.5 E
(ut do print gobs of deb)-.2 E(ugging information.)-.2 E F2 .833<ad44>
108 532.8 S F0(Both display and print deb)21.414 E(ugging info.)-.2 E F2
.833<ad66>108 549.6 S F0(Equi)25.304 E -.25(va)-.25 G(lent to).25 E F2
(whatis)2.5 E F0(.)A F2 .833<ad46>108 566.4 S F0(or)1.667 E F2<adad7072>
2.5 E(ef)-.18 E(ormat)-.25 E F0 -.15(Fo)144 578.4 S
(rmat only - do not display).15 E(.)-.65 E F2 .833<ad68>108 595.2 S F0
(Print a one-line help message and e)23.074 E(xit.)-.15 E F2 .833<ad6b>
108 612 S F0(Equi)23.074 E -.25(va)-.25 G(lent to).25 E F2(apr)2.5 E
(opos)-.18 E F0(.)A F2 .833<ad4b>108 628.8 S F0 .328
(Search for the speci\214ed string in *all* man pages. W)20.854 F .328
(arning: this is probably v)-.8 F .329(ery slo)-.15 F .329
(w! It helps to)-.25 F .024(specify a section.)144 640.8 R .023
(\(Just to gi)5.024 F .323 -.15(ve a r)-.25 H .023
(ough idea, on my machine this tak).15 F .023
(es about a minute per 500 man)-.1 F(pages.\))144 652.8 Q F2 .834 .833
(\255m s)108 669.6 T(ystem)-.833 E F0(Specify an alternate set of man p\
ages to search based on the system name gi)144 681.6 Q -.15(ve)-.25 G
(n.).15 E F2 .834 .833(\255p s)108 698.4 T(tring)-.833 E F0 .043
(Specify the sequence of preprocessors to run before)144 710.4 R F2(nr)
2.543 E(off)-.18 E F0(or)2.543 E F2(tr)2.543 E(off)-.18 E F0 5.043(.N)C
.043(ot all installations will ha)-5.043 F .344 -.15(ve a)-.2 H 1.128
(full set of preprocessors.)144 722.4 R 1.127
(Some of the preprocessors and the letters used to designate them are:)
6.128 F(September 2, 1995)268.365 768 Q(1)191.365 E 0 Cg EP
%%Page: 2 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 407.74(man\(1\) man\(1\))72 48 R .609(eqn \(e\)\
, grap \(g\), pic \(p\), tbl \(t\), vgrind \(v\), refer \(r\).)144 84 R
.609(This option o)5.609 F -.15(ve)-.15 G .609(rrides the).15 F/F1 10
/Times-Bold@0 SF(MANR)3.109 E(OFFSEQ)-.3 E F0(en)144 96 Q(vironment v)
-.4 E(ariable.)-.25 E F1 .833<ad74>108 112.8 S F0(Use)25.304 E F1
(/usr/bin/gr)3.32 E .82(off -Tps -mandoc)-.18 F F0 .819
(to format the manual page, passing the output to)3.32 F F1(stdout.)
3.319 E F0(The)5.819 E .919(output from)144 124.8 R F1(/usr/bin/gr)3.419
E .919(off -Tps -mandoc)-.18 F F0 .919
(may need to be passed through some \214lter or another)3.419 F
(before being printed.)144 136.8 Q F1 .833<ad77>108 153.6 S F0(or)1.667
E F1(\255\255path)2.5 E F0(Don')144 165.6 Q 2.623(ta)-.18 G .123
(ctually display the man pages, b)-2.623 F .122
(ut do print the location\(s\) of the \214les that w)-.2 F .122
(ould be format-)-.1 F .291(ted or displayed. If no ar)144 177.6 R .292
(gument is gi)-.18 F -.15(ve)-.25 G .292
(n: display \(on stdout\) the list of directories that is searched).15 F
(by)144 189.6 Q F1(man)2.589 E F0 .089(for man pages. If)2.589 F F1
(manpath)2.589 E F0 .089(is a link to man, then "manpath" is equi)2.589
F -.25(va)-.25 G .088(lent to "man --path".).25 F F1 .833<ad57>108 206.4
S F0(Lik)18.634 E 3.086<65ad>-.1 G 1.886 -.65(w, b)-2.253 H .586
(ut print \214le names one per line, without additional information.).45
F .586(This is useful in shell)5.586 F(commands lik)144 218.4 Q(e)-.1 E
F1(man -aW man | xar)2.5 E(gs ls -l)-.1 E/F2 10.95/Times-Bold@0 SF(CA)72
247.2 Q 2.738(TP)-1.04 G -.602(AG)-3.548 G(ES).602 E F0 .077
(Man will try to sa)108 259.2 R .377 -.15(ve t)-.2 H .077
(he formatted man pages, in order to sa).15 F .376 -.15(ve f)-.2 H .076
(ormatting time the ne).15 F .076(xt time these pages are)-.15 F 3.722
(needed. T)108 271.2 R(raditionally)-.35 E 3.722(,f)-.65 G 1.222
(ormatted v)-3.722 F 1.222(ersions of pages in DIR/manX are sa)-.15 F
-.15(ve)-.2 G 3.722(di).15 G 3.722(nD)-3.722 G 1.222(IR/catX, b)-3.722 F
1.223(ut other map-)-.2 F .363
(pings from man dir to cat dir can be speci\214ed in)108 283.2 R F1
(/etc/man.conf)2.863 E F0 5.363(.N)C 2.862(oc)-5.363 G .362
(at pages are sa)-2.862 F -.15(ve)-.2 G 2.862(dw).15 G .362
(hen the required)-2.862 F .056(cat directory does not e)108 295.2 R
2.556(xist. No)-.15 F .056(cat pages are sa)2.556 F -.15(ve)-.2 G 2.556
(dw).15 G .056(hen the)-2.556 F 2.556(ya)-.15 G .057
(re formatted for a line length dif)-2.556 F .057(ferent from)-.25 F 2.5
(80. No)108 307.2 R(cat pages are sa)2.5 E -.15(ve)-.2 G 2.5(dw).15 G
(hen man.conf contains the line NOCA)-2.5 E(CHE.)-.4 E .16
(It is possible to mak)108 324 R(e)-.1 E F1(man)2.66 E F0 .16
(suid to a user man. Then, if a cat directory has o)2.66 F .16
(wner man and mode 0755 \(only)-.25 F .55
(writable by man\), and the cat \214les ha)108 336 R .85 -.15(ve o)-.2 H
.55(wner man and mode 0644 or 0444 \(only writable by man, or not)-.1 F
.673(writable at all\), no ordinary user can change the cat pages or pu\
t other \214les in the cat directory)108 348 R 3.172(.I)-.65 G(f)-3.172
E F1(man)3.172 E F0(is)3.172 E .958
(not made suid, then a cat directory should ha)108 360 R 1.258 -.15
(ve m)-.2 H .958(ode 0777 if all users should be able to lea).15 F 1.258
-.15(ve c)-.2 H .958(at pages).15 F(there.)108 372 Q(The option)108
388.8 Q F1<ad63>2.5 E F0(forces reformatting a page, e)2.5 E -.15(ve)
-.25 G 2.5(ni).15 G 2.5(far)-2.5 G(ecent cat page e)-2.5 E(xists.)-.15 E
F2(SEARCH P)72 429.6 Q -1.04(AT)-.81 G 2.738(HF)1.04 G(OR MANU)-2.738 E
(AL P)-.657 E -.602(AG)-.81 G(ES).602 E F1(man)108 441.6 Q F0 .068(uses\
 a sophisticated method of \214nding manual page \214les, based on the \
in)2.569 F -.2(vo)-.4 G .068(cation options and en).2 F(viron-)-.4 E
(ment v)108 453.6 Q(ariables, the)-.25 E F1(/etc/man.conf)2.5 E F0
(con\214guration \214le, and some b)2.5 E(uilt in con)-.2 E -.15(ve)-.4
G(ntions and heuristics.).15 E 1.213(First of all, when the)108 470.4 R
/F3 10/Times-Italic@0 SF(name)4.073 E F0(ar)3.893 E 1.214(gument to)-.18
F F1(man)3.714 E F0 1.214(contains a slash \()3.714 F F1(/)A F0(\),)A F1
(man)3.714 E F0 1.214(assumes it is a \214le speci\214cation)3.714 F
(itself, and there is no searching in)108 482.4 Q -.2(vo)-.4 G(lv).2 E
(ed.)-.15 E .427(But in the normal case where)108 499.2 R F3(name)3.287
E F0(doesn')3.106 E 2.926(tc)-.18 G .426(ontain a slash,)-2.926 F F1
(man)2.926 E F0 .426(searches a v)2.926 F .426
(ariety of directories for a \214le)-.25 F
(that could be a manual page for the topic named.)108 511.2 Q .178
(If you specify the)108 528 R F1(-M)2.679 E F3(pathlist)3.929 E F0
(option,)2.679 E F3(pathlist)3.929 E F0 .179
(is a colon-separated list of the directories that)3.359 F F1(man)2.679
E F0(searches.)2.679 E .074(If you don')108 544.8 R 2.574(ts)-.18 G
(pecify)-2.574 E F1(-M)2.574 E F0 -.2(bu)2.574 G 2.574(ts).2 G .074
(et the)-2.574 F F1(MANP)2.574 E -.95(AT)-.74 G(H).95 E F0(en)2.574 E
.074(vironment v)-.4 F .074(ariable, the v)-.25 F .073(alue of that v)
-.25 F .073(ariable is the list of)-.25 F(the directories that)108 556.8
Q F1(man)2.5 E F0(searches.)2.5 E .54(If you don')108 573.6 R 3.04(ts)
-.18 G .54(pecify an e)-3.04 F .54(xplicit path list with)-.15 F F1(-M)
3.04 E F0(or)3.04 E F1(MANP)3.04 E -.95(AT)-.74 G(H).95 E F0(,)A F1(man)
3.04 E F0(de)3.04 E -.15(ve)-.25 G .54(lops its o).15 F .54
(wn path list based on)-.25 F .843
(the contents of the con\214guration \214le)108 585.6 R F1
(/etc/man.conf)3.342 E F0 5.842(.T)C(he)-5.842 E F1(MANP)3.342 E -.95
(AT)-.74 G(H).95 E F0 .842(statements in the con\214guration \214le)
3.342 F(identify particular directories to include in the search path.)
108 597.6 Q .204(Furthermore, the)108 614.4 R F1(MANP)2.704 E -.95(AT)
-.74 G(H_MAP).95 E F0 .205
(statements add to the search path depending on your command search)
2.704 F .172(path \(i.e. your)108 626.4 R F1 -.74(PA)2.672 G(TH)-.21 E
F0(en)2.671 E .171(vironment v)-.4 F 2.671(ariable\). F)-.25 F .171
(or each directory that may be in the command search path, a)-.15 F F1
(MANP)108 638.4 Q -.95(AT)-.74 G(H_MAP).95 E F0 .381(statement speci\
\214es a directory that should be added to the search path for manual p\
age)2.881 F(\214les.)108 650.4 Q F1(man)6.674 E F0 1.673(looks at the)
4.174 F F1 -.74(PA)4.173 G(TH)-.21 E F0 -.25(va)4.173 G 1.673(riable an\
d adds the corresponding directories to the manual page \214le).25 F
.286(search path.)108 662.4 R .287(Thus, with the proper use of)5.286 F
F1(MANP)2.787 E -.95(AT)-.74 G(H_MAP).95 E F0 2.787(,w)C .287
(hen you issue the command)-2.787 F F1 .287(man xyz)2.787 F F0 2.787(,y)
C(ou)-2.787 E(get a manual page for the program that w)108 674.4 Q
(ould run if you issued the command)-.1 E F1(xyz)2.5 E F0(.)A .368
(In addition, for each directory in the command search path \(we')108
691.2 R .368(ll call it a "command directory"\) for which)-.1 F 1.508
(you do)108 703.2 R F3(not)4.368 E F0(ha)4.688 E 1.808 -.15(ve a)-.2 H
F1(MANP)4.158 E -.95(AT)-.74 G(H_MAP).95 E F0(statement,)4.008 E F1(man)
4.009 E F0 1.509(automatically looks for a manual page directory)4.009 F
.934("nearby" namely as a subdirectory in the command directory itself \
or in the parent directory of the com-)108 715.2 R(mand directory)108
727.2 Q(.)-.65 E(September 2, 1995)268.365 768 Q(2)191.365 E 0 Cg EP
%%Page: 3 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 407.74(man\(1\) man\(1\))72 48 R -1.1(Yo)108 84
S 7.128(uc)1.1 G 4.628
(an disable the automatic "nearby" searches by including a)-7.128 F/F1
10/Times-Bold@0 SF(NO)7.129 E -.5(AU)-.4 G -.18(TO).5 G -.74(PA).18 G
(TH)-.21 E F0 4.629(statement in)7.129 F F1(/etc/man.conf)108 96 Q F0(.)
A .659(In each directory in the search path as described abo)108 112.8 R
-.15(ve)-.15 G(,).15 E F1(man)3.159 E F0 .659
(searches for a \214le named)3.159 F/F2 10/Times-Italic@0 SF(topic)3.158
E F1(.).31 E F2(section).34 E F0 3.158(,w)C(ith)-3.158 E .405
(an optional suf)108 124.8 R .405
(\214x on the section number and possibly a compression suf)-.25 F 2.905
(\214x. If)-.25 F .405(it doesn')2.905 F 2.906<748c>-.18 G .406
(nd such a \214le, it)-2.906 F .167(then looks in an)108 136.8 R 2.667
(ys)-.15 G .167(ubdirectories named)-2.667 F F1(man)2.667 E F2(N).7 E F0
(or)2.666 E F1(cat)2.666 E F2(N).7 E F0(where)2.666 E F2(N)3.366 E F0
.166(is the manual section number)3.766 F 5.166(.I)-.55 G 2.666(ft)
-5.166 G .166(he \214le is)-2.666 F 2.14(in a)108 148.8 R F1(cat)4.64 E
F2(N).7 E F0(subdirectory)4.64 E(,)-.65 E F1(man)4.64 E F0 2.14
(assumes it is a formatted manual page \214le \(cat page\).)4.64 F
(Otherwise,)7.14 E F1(man)4.64 E F0 .81(assumes it is unformatted.)108
160.8 R .81(In either case, if the \214lename has a kno)5.81 F .81
(wn compression suf)-.25 F .81(\214x \(lik)-.25 F(e)-.1 E F1(.gz)3.31 E
F0(\),)A F1(man)3.31 E F0(assumes it is gzipped.)108 172.8 Q .32
(If you w)108 189.6 R .321(ant to see where \(or if\))-.1 F F1(man)2.821
E F0 -.1(wo)2.821 G .321
(uld \214nd the manual page for a particular topic, use the).1 F F1
(--path)2.821 E F0(\()2.821 E F1(-w)A F0(\))A(option.)108 201.6 Q/F3
10.95/Times-Bold@0 SF(ENVIR)72 230.4 Q(ONMENT)-.329 E F1(MANP)108 242.4
Q -.95(AT)-.74 G(H).95 E F0(If)144 254.4 Q F1(MANP)2.72 E -.95(AT)-.74 G
(H).95 E F0 .22(is set,)2.72 F F1(man)2.72 E F0 .219
(uses it as the path to search for manual page \214les.)2.72 F .219
(It o)5.219 F -.15(ve)-.15 G .219(rrides the con-).15 F .772
(\214guration \214le and the automatic search path, b)144 266.4 R .773
(ut is o)-.2 F -.15(ve)-.15 G .773(rridden by the).15 F F1(-M)3.273 E F0
(in)3.273 E -.2(vo)-.4 G .773(cation option.).2 F(See)5.773 E F1
(SEARCH P)144 278.4 Q -.95(AT)-.74 G 2.5(HF).95 G(OR MANU)-2.5 E(AL P)
-.6 E -.55(AG)-.74 G(ES).55 E F0(.)A F1(MANPL)108 295.2 Q F0(If)144
307.2 Q F1(MANPL)2.665 E F0 .165(is set, its v)2.665 F .165
(alue is used as the display page length.)-.25 F .165
(Otherwise, the entire man page will)5.165 F(occup)144 319.2 Q 2.5(yo)
-.1 G(ne \(long\) page.)-2.5 E F1(MANR)108 336 Q(OFFSEQ)-.3 E F0(If)144
348 Q F1(MANR)3.278 E(OFFSEQ)-.3 E F0 .778(is set, its v)3.278 F .778
(alue is used to determine the set of preprocessors run before run-)-.25
F(ning)144 360 Q F1(nr)2.5 E(off)-.18 E F0(or)2.5 E F1(tr)2.5 E(off)-.18
E F0 5(.B)C 2.5(yd)-5 G(ef)-2.5 E
(ault, pages are passed through the tbl preprocessor before)-.1 E F1(nr)
2.5 E(off)-.18 E F0(.)A F1(MANSECT)108 376.8 Q F0(If)144 388.8 Q F1
(MANSECT)2.5 E F0(is set, its v)2.5 E
(alue is used to determine which manual sections to search.)-.25 E F1
(MANWIDTH)108 405.6 Q F0(If)144 417.6 Q F1(MANWIDTH)3.327 E F0 .827
(is set, its v)3.327 F .827
(alue is used as the width manpages should be displayed.)-.25 F
(Otherwise)5.826 E(the pages may be displayed o)144 429.6 Q -.15(ve)-.15
G 2.5(rt).15 G(he whole width of your screen.)-2.5 E F1(MANP)108 446.4 Q
-.55(AG)-.74 G(ER).55 E F0(If)144 458.4 Q F1(MANP)2.518 E -.55(AG)-.74 G
(ER).55 E F0 .018(is set, its v)2.518 F .019(alue is used as the name o\
f the program to use to display the man page.)-.25 F(If not, then)144
470.4 Q F1 -1.57 -.74(PA G)2.5 H(ER).74 E F0(is used. If that has no v)
2.5 E(alue either)-.25 E(,)-.4 E F1(/usr/bin/less -is)2.5 E F0(is used.)
2.5 E F1(LANG)108 487.2 Q F0(If)7.11 E F1(LANG)4.048 E F0 1.547
(is set, its v)4.047 F 1.547(alue de\214nes the name of the subdirector\
y where man \214rst looks for man)-.25 F .239(pages. Thus, the command \
`LANG=dk man 1 foo' will cause man to look for the foo man page in)144
499.2 R .175(.../dk/man1/foo.1, and if it cannot \214nd such a \214le, \
then in .../man1/foo.1, where ... is a directory on)144 511.2 R
(the search path.)144 523.2 Q F1(NLSP)108 540 Q -.95(AT)-.74 G
(H, LC_MESSA).95 E(GES, LANG)-.55 E F0 .465(The en)144 552 R .465
(vironment v)-.4 F(ariables)-.25 E F1(NLSP)2.965 E -.95(AT)-.74 G(H).95
E F0(and)2.965 E F1(LC_MESSA)2.965 E(GES)-.55 E F0(\(or)2.965 E F1(LANG)
2.965 E F0 .465(when the latter does not)2.965 F -.15(ex)144 564 S .267
(ist\) play a role in locating the message catalog.).15 F .266
(\(But the English messages are compiled in, and)5.266 F 1.288
(for English no catalog is required.\))144 576 R 1.288
(Note that programs lik)6.288 F(e)-.1 E F1(col\(1\))3.788 E F0 1.288
(called by man also use e.g.)3.788 F(LC_CTYPE.)144 588 Q F1 -.74(PA)108
604.8 S 7.41(TH P)-.21 F -.95(AT)-.74 G(H).95 E F0 .476
(helps determine the search path for manual page \214les.)2.976 F(See)
5.476 E F1 .475(SEARCH P)2.975 F -.95(AT)-.74 G 2.975(HF).95 G .475
(OR MAN-)-2.975 F -.6(UA)144 616.8 S 2.5(LP).6 G -.55(AG)-3.24 G(ES).55
E F0(.)A F1(SYSTEM)108 633.6 Q(SYSTEM)144 645.6 Q F0
(is used to get the def)2.5 E
(ault alternate system name \(for use with the)-.1 E F1<ad6d>2.5 E F0
(option\).)2.5 E F3(SEE ALSO)72 662.4 Q F0
(apropos\(1\), whatis\(1\), less\(1\), grof)108 674.4 Q
(f\(1\), man.conf\(5\).)-.25 E F3 -.11(BU)72 691.2 S(GS).11 E F0(The)108
703.2 Q F1<ad74>2.5 E F0(option only w)2.5 E(orks if a trof)-.1 E(f-lik)
-.25 E 2.5(ep)-.1 G(rogram is installed.)-2.5 E
(If you see blinking \\255 or <AD> instead of h)108 715.2 Q
(yphens, put `LESSCHARSET=latin1' in your en)-.05 E(vironment.)-.4 E
(September 2, 1995)268.365 768 Q(3)191.365 E 0 Cg EP
%%Page: 4 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 407.74(man\(1\) man\(1\))72 48 R/F1 10.95
/Times-Bold@0 SF(TIPS)72 84 Q F0(If you add the line)108 96 Q
(\(global-set-k)113 120 Q .3 -.15(ey [)-.1 H
(\(f1\)] \(lambda \(\) \(interacti).15 E -.15(ve)-.25 G 2.5(\)\().15 G
(manual-entry \(current-w)-2.5 E(ord\)\)\)\))-.1 E .156(to your)108 144
R/F2 10/Times-Italic@0 SF(.emacs)2.656 E F0 .156
(\214le, then hitting F1 will gi)2.656 F .457 -.15(ve y)-.25 H .157
(ou the man page for the library call at the current cursor posi-).15 F
(tion.)108 156 Q 1.6 -.8(To g)108 172.8 T(et a plain te).8 E(xt v)-.15 E
(ersion of a man page, without backspaces and underscores, try)-.15 E
2.5(#m)113 196.8 S(an foo | col -b > foo.mantxt)-2.5 E
(September 2, 1995)268.365 768 Q(4)191.365 E 0 Cg EP
%%Trailer
end
%%EOF