%!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-3.393 E/F3 10 /Times-Italic@0 SF(system)3.393 E F0 3.393(][).32 G F2-3.393 E F3 (string)3.393 E F0 3.393(][).22 G F2-3.393 E F3(con\214g_\214le) 3.393 E F0 3.393(][).18 G F2-3.393 E F3(pathlist)3.393 E F0 3.393 (][).68 G F2-3.393 E F3(pa)3.393 E -.1(ge)-.1 G(r).1 E F0 3.393 (][).73 G F2-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 F24.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 .833108 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 .833108 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 .833108 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 108 532.8 S F0(Both display and print deb)21.414 E(ugging info.)-.2 E F2 .833108 549.6 S F0(Equi)25.304 E -.25(va)-.25 G(lent to).25 E F2 (whatis)2.5 E F0(.)A F2 .833108 566.4 S F0(or)1.667 E F2 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 .833108 595.2 S F0 (Print a one-line help message and e)23.074 E(xit.)-.15 E F2 .833 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 .833108 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 .833108 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 .833108 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 .833108 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 F12.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 F12.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 F12.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 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