%!PS-Adobe-2.0 %%Version: 0.1 %%DocumentFonts: (atend) %%Pages: (atend) %%EndComments % % Version 3.3.2 prologue for troff files. % /#copies 1 store /aspectratio 1 def /formsperpage 1 def /landscape false def /linewidth .3 def /magnification 1 def /margin 0 def /orientation 0 def /resolution 720 def /rotation 1 def /xoffset 0 def /yoffset 0 def /roundpage true def /useclippath true def /pagebbox [0 0 612 792] def /R /Times-Roman def /I /Times-Italic def /B /Times-Bold def /BI /Times-BoldItalic def /H /Helvetica def /HI /Helvetica-Oblique def /HB /Helvetica-Bold def /HX /Helvetica-BoldOblique def /CW /Courier def /CO /Courier def /CI /Courier-Oblique def /CB /Courier-Bold def /CX /Courier-BoldOblique def /PA /Palatino-Roman def /PI /Palatino-Italic def /PB /Palatino-Bold def /PX /Palatino-BoldItalic def /Hr /Helvetica-Narrow def /Hi /Helvetica-Narrow-Oblique def /Hb /Helvetica-Narrow-Bold def /Hx /Helvetica-Narrow-BoldOblique def /KR /Bookman-Light def /KI /Bookman-LightItalic def /KB /Bookman-Demi def /KX /Bookman-DemiItalic def /AR /AvantGarde-Book def /AI /AvantGarde-BookOblique def /AB /AvantGarde-Demi def /AX /AvantGarde-DemiOblique def /NR /NewCenturySchlbk-Roman def /NI /NewCenturySchlbk-Italic def /NB /NewCenturySchlbk-Bold def /NX /NewCenturySchlbk-BoldItalic def /ZD /ZapfDingbats def /ZI /ZapfChancery-MediumItalic def /S /S def /S1 /S1 def /GR /Symbol def /inch {72 mul} bind def /min {2 copy gt {exch} if pop} bind def /setup { counttomark 2 idiv {def} repeat pop landscape {/orientation 90 orientation add def} if /scaling 72 resolution div def linewidth setlinewidth 1 setlinecap pagedimensions xcenter ycenter translate orientation rotation mul rotate width 2 div neg height 2 div translate xoffset inch yoffset inch neg translate margin 2 div dup neg translate magnification dup aspectratio mul scale scaling scaling scale addmetrics 0 0 moveto } def /pagedimensions { useclippath userdict /gotpagebbox known not and { /pagebbox [clippath pathbbox newpath] def roundpage currentdict /roundpagebbox known and {roundpagebbox} if } if pagebbox aload pop 4 -1 roll exch 4 1 roll 4 copy landscape {4 2 roll} if sub /width exch def sub /height exch def add 2 div /xcenter exch def add 2 div /ycenter exch def userdict /gotpagebbox true put } def /addmetrics { /Symbol /S null Sdefs cf /Times-Roman /S1 StandardEncoding dup length array copy S1defs cf } def /pagesetup { /page exch def currentdict /pagedict known currentdict page known and { page load pagedict exch get cvx exec } if } def /decodingdefs [ {counttomark 2 idiv {y moveto show} repeat} {neg /y exch def counttomark 2 idiv {y moveto show} repeat} {neg moveto {2 index stringwidth pop sub exch div 0 32 4 -1 roll widthshow} repeat} {neg moveto {spacewidth sub 0.0 32 4 -1 roll widthshow} repeat} {counttomark 2 idiv {y moveto show} repeat} {neg setfunnytext} ] def /setdecoding {/t decodingdefs 3 -1 roll get bind def} bind def /w {neg moveto show} bind def /m {neg dup /y exch def moveto} bind def /done {/lastpage where {pop lastpage} if} def /f { dup /font exch def findfont exch dup /ptsize exch def scaling div dup /size exch def scalefont setfont linewidth ptsize mul scaling 10 mul div setlinewidth /spacewidth ( ) stringwidth pop def } bind def /changefont { /fontheight exch def /fontslant exch def currentfont [ 1 0 fontheight ptsize div fontslant sin mul fontslant cos div fontheight ptsize div 0 0 ] makefont setfont } bind def /sf {f} bind def /cf { dup length 2 idiv /entries exch def /chtab exch def /newencoding exch def /newfont exch def findfont dup length 1 add dict /newdict exch def {1 index /FID ne {newdict 3 1 roll put}{pop pop} ifelse} forall newencoding type /arraytype eq {newdict /Encoding newencoding put} if newdict /Metrics entries dict put newdict /Metrics get begin chtab aload pop 1 1 entries {pop def} for newfont newdict definefont pop end } bind def % % A few arrays used to adjust reference points and character widths in some % of the printer resident fonts. If square roots are too high try changing % the lines describing /radical and /radicalex to, % % /radical [0 -75 550 0] % /radicalex [-50 -75 500 0] % % Move braceleftbt a bit - default PostScript character is off a bit. % /Sdefs [ /bracketlefttp [201 500] /bracketleftbt [201 500] /bracketrighttp [-81 380] /bracketrightbt [-83 380] /braceleftbt [203 490] /bracketrightex [220 -125 500 0] /radical [0 0 550 0] /radicalex [-50 0 500 0] /parenleftex [-20 -170 0 0] /integral [100 -50 500 0] /infinity [10 -75 730 0] ] def /S1defs [ /underscore [0 80 500 0] /endash [7 90 650 0] ] def % % Tries to round clipping path dimensions, as stored in array pagebbox, so they % match one of the known sizes in the papersizes array. Lower left coordinates % are always set to 0. % /roundpagebbox { 7 dict begin /papersizes [8.5 inch 11 inch 14 inch 17 inch] def /mappapersize { /val exch def /slop .5 inch def /diff slop def /j 0 def 0 1 papersizes length 1 sub { /i exch def papersizes i get val sub abs dup diff le {/diff exch def /j i def} {pop} ifelse } for diff slop lt {papersizes j get} {val} ifelse } def pagebbox 0 0 put pagebbox 1 0 put pagebbox dup 2 get mappapersize 2 exch put pagebbox dup 3 get mappapersize 3 exch put end } bind def %%EndProlog %%BeginSetup mark % % Encoding vector and redefinition of findfont for the ISO Latin1 standard. % The 18 characters missing from ROM based fonts on older printers are noted % below. % /ISOLatin1Encoding [ /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.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 /minus /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 /asciicircum /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 /asciitilde /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /dotlessi /grave /acute /circumflex /tilde /macron /breve /dotaccent /dieresis /.notdef /ring /cedilla /.notdef /hungarumlaut /ogonek /caron /space /exclamdown /cent /sterling /currency /yen /brokenbar % missing /section /dieresis /copyright /ordfeminine /guillemotleft /logicalnot /hyphen /registered /macron /degree % missing /plusminus % missing /twosuperior % missing /threesuperior % missing /acute /mu % missing /paragraph /periodcentered /cedilla /onesuperior % missing /ordmasculine /guillemotright /onequarter % missing /onehalf % missing /threequarters % missing /questiondown /Agrave /Aacute /Acircumflex /Atilde /Adieresis /Aring /AE /Ccedilla /Egrave /Eacute /Ecircumflex /Edieresis /Igrave /Iacute /Icircumflex /Idieresis /Eth % missing /Ntilde /Ograve /Oacute /Ocircumflex /Otilde /Odieresis /multiply % missing /Oslash /Ugrave /Uacute /Ucircumflex /Udieresis /Yacute % missing /Thorn % missing /germandbls /agrave /aacute /acircumflex /atilde /adieresis /aring /ae /ccedilla /egrave /eacute /ecircumflex /edieresis /igrave /iacute /icircumflex /idieresis /eth % missing /ntilde /ograve /oacute /ocircumflex /otilde /odieresis /divide % missing /oslash /ugrave /uacute /ucircumflex /udieresis /yacute % missing /thorn % missing /ydieresis ] def /NewFontDirectory FontDirectory maxlength dict def % % Apparently no guarantee findfont is defined in systemdict so the obvious % % systemdict /findfont get exec % % can generate an error. So far the only exception is a VT600 (version 48.0). % userdict /@RealFindfont known not { userdict begin /@RealFindfont systemdict begin /findfont load end def end } if /findfont { dup NewFontDirectory exch known not { dup %dup systemdict /findfont get exec % not always in systemdict dup userdict /@RealFindfont get exec dup /Encoding get StandardEncoding eq { dup length dict begin {1 index /FID ne {def}{pop pop} ifelse} forall /Encoding ISOLatin1Encoding def currentdict end /DummyFontName exch definefont } if NewFontDirectory 3 1 roll put } if NewFontDirectory exch get } bind def setup %%EndSetup %%Page: 1 1 /saveobj save def mark 1 pagesetup 12 /LucidaSans-Demi f (How to) 1809 1220 w (Write) 2285 1220 w (a) 2645 1220 w (Plan 9) 2754 1220 w (Manual) 3170 1220 w (Page) 3657 1220 w 10 /LucidaSans-Italic f (Geoff Collyer) 2566 1480 w (Russ Cox) 2663 1620 w (\(following Henry Spencer\)) 2258 1760 w 10 /LucidaTypewriter f (geoff@collyer.net) 2268 1960 w (rsc@swtch.com) 2412 2100 w 10 /LucidaSansUnicode00 f (This) 720 2616 w (document) 958 2616 w (is) 1476 2616 w (an) 1589 2616 w (introduction) 1739 2616 w (to) 2367 2616 w (writing) 2498 2616 w (a) 2868 2616 w (Plan) 2956 2616 w (9) 3190 2616 w (manual) 3286 2616 w (page) 3675 2616 w (using) 3944 2616 w (the) 4243 2616 w 10 /LucidaSans-Italic f (troff) 4431 2616 w 10 /LucidaSansUnicode00 f (manual) 4684 2616 w (page) 720 2736 w (macros.) 990 2736 w (It) 1440 2736 w (does) 1540 2736 w (not) 1805 2736 w (cover) 1999 2736 w (every) 2294 2736 w (last) 2585 2736 w (detail;) 2791 2736 w (judgement) 3126 2736 w (and) 3681 2736 w (good) 3895 2736 w (taste) 4176 2736 w (are) 4445 2736 w (still) 4630 2736 w (nec\255) 4838 2736 w (essary) 720 2856 w (for) 1079 2856 w (writing) 1271 2856 w (readable) 1661 2856 w (documentation,) 2132 2856 w (especially) 2946 2856 w (when) 3471 2856 w (striving) 3782 2856 w (for) 4199 2856 w (clarity) 4392 2856 w (in) 4740 2856 w (the) 4885 2856 w (extremely) 720 2976 w (concise) 1253 2976 w (format) 1666 2976 w (encouraged) 2041 2976 w (by) 2661 2976 w (Plan) 2827 2976 w (9.) 3079 2976 w (This) 3257 2976 w (document) 3513 2976 w (is) 4049 2976 w (derived) 4180 2976 w (originally) 4591 2976 w (from a similar document written for Unix by Henry Spencer.) 720 3096 w (Manual) 720 3252 w (pages) 1102 3252 w (are) 1422 3252 w (stored) 1608 3252 w (as) 1951 3252 w 10 /LucidaSans-Italic f (troff) 2091 3252 w 10 /LucidaSansUnicode00 f (source) 2344 3252 w (files.) 2700 3252 w (The) 3000 3252 w (manual) 3215 3252 w 10 /LucidaSansUnicode20 f (\030\030) 3605 3252 w 10 /LucidaSansUnicode00 f (page) 3669 3252 w 10 /LucidaSansUnicode20 f (\031\031) 3905 3252 w 10 /LucidaSansUnicode00 f (is) 4003 3252 w (a) 4117 3252 w (single) 4206 3252 w (file) 4529 3252 w (even) 4714 3252 w (if) 4974 3252 w (the) 720 3372 w (printed) 934 3372 w (form) 1344 3372 w (is) 1635 3372 w (several) 1774 3372 w (pages) 2173 3372 w (long.) 2519 3372 w (The) 2856 3372 w (formatting) 3095 3372 w (macros) 3667 3372 w (are) 4077 3372 w (documented) 4287 3372 w (in) 4949 3372 w 10 /LucidaSans-Italic f (man) 720 3492 w 10 /LucidaSansUnicode00 f (\(6\).) 936 3492 w (This) 1168 3492 w (document) 1412 3492 w (is) 1936 3492 w (a) 2055 3492 w (more) 2149 3492 w (detailed) 2439 3492 w (explanation) 2866 3492 w (of) 3475 3492 w (them,) 3612 3492 w (with) 3931 3492 w (examples) 4175 3492 w (of) 4678 3492 w (their) 4815 3492 w (usage.) 720 3612 w (This) 720 3768 w (document) 964 3768 w (first) 1488 3768 w (describes) 1722 3768 w (the) 2222 3768 w (low-level) 2416 3768 w (text) 2903 3768 w (formatting) 3134 3768 w (and) 3688 3768 w (then) 3908 3768 w (discusses) 4165 3768 w (higher-) 4670 3768 w (level manual page considerations.) 720 3888 w 10 /LucidaSans-Demi f (Fonts) 720 4128 w 10 /LucidaSansUnicode00 f (Manual) 720 4284 w (pages) 1103 4284 w (make) 1424 4284 w (fairly) 1720 4284 w (heavy) 1997 4284 w (use) 2308 4284 w (of) 2511 4284 w 10 /LucidaSans-Italic f (italic) 2643 4284 w 10 /LucidaSansUnicode00 f (and) 2913 4284 w 10 /LucidaTypewriter f (fixed-width) 3128 4284 w 10 /LucidaSansUnicode00 f (fonts.) 3955 4284 w (There) 4302 4284 w (are) 4615 4284 w (stan\255) 4802 4284 w (dard) 720 4404 w (macros) 985 4404 w (for) 1380 4404 w (switching) 1562 4404 w (fonts.) 2065 4404 w (All) 2419 4404 w (of) 2588 4404 w (them) 2728 4404 w (change) 3018 4404 w (the) 3408 4404 w (font) 3605 4404 w (of) 3844 4404 w (a) 3984 4404 w (small) 4081 4404 w (piece) 4380 4404 w (of) 4677 4404 w (text;) 4817 4404 w (the) 720 4524 w (text) 913 4524 w (is) 1142 4524 w (either) 1260 4524 w (the) 1579 4524 w (arguments) 1772 4524 w (to) 2329 4524 w (the) 2465 4524 w (macro) 2658 4524 w (\(up) 2997 4524 w (to) 3193 4524 w (6) 3329 4524 w (words) 3430 4524 w (or) 3761 4524 w (strings) 3901 4524 w (in) 4272 4524 w (quotes\)) 4401 4524 w (or,) 4802 4524 w (if) 4974 4524 w (no) 720 4644 w (argument) 884 4644 w (is) 1393 4644 w (given,) 1514 4644 w (the) 1847 4644 w (next) 2042 4644 w (text) 2298 4644 w (line.) 2529 4644 w (None) 2809 4644 w (of) 3102 4644 w (these) 3240 4644 w (macros) 3542 4644 w (break) 3934 4644 w (the) 4247 4644 w (current) 4442 4644 w (line,) 4832 4644 w (so they may be used anywhere in text.) 720 4764 w 10 /LucidaTypewriter f (.) 702 4920 w (I) 756 4920 w 10 /LucidaSansUnicode00 f (,) 836 4920 w 10 /LucidaTypewriter f (.) 897 4920 w (B) 951 4920 w 10 /LucidaSansUnicode00 f (and) 1078 4920 w 10 /LucidaTypewriter f (.) 1287 4920 w (L) 1341 4920 w 10 /LucidaSansUnicode00 f (provide) 1468 4920 w (italic,) 1880 4920 w (fixed-width) 2190 4920 w (\(formerly) 2810 4920 w (bold\),) 3301 4920 w (and) 3630 4920 w (literal) 3858 4920 w (\(fixed-width) 4182 4920 w (with) 4835 4920 w (single) 720 5040 w (quotes) 1049 5040 w (around) 1419 5040 w (it) 1802 5040 w (in) 1907 5040 w 10 /LucidaSans-Italic f (nroff) 2037 5040 w 10 /LucidaSansUnicode00 f (\)) 2280 5040 w (text.) 2352 5040 w (While) 2646 5040 w (the) 2947 5040 w 10 /LucidaTypewriter f (.) 3123 5040 w (B) 3177 5040 w 10 /LucidaSansUnicode00 f (macro) 3296 5040 w (uses) 3636 5040 w (fixed-width) 3895 5040 w (font,) 4506 5040 w (the) 4774 5040 w 10 /LucidaTypewriter f (B) 4968 5040 w 10 /LucidaSansUnicode00 f (font) 720 5160 w (\(selected) 966 5160 w (using) 1447 5160 w 10 /LucidaTypewriter f (\\fB) 1762 5160 w 10 /LucidaSansUnicode00 f (\)) 1978 5160 w (is) 2061 5160 w (still) 2191 5160 w (bold.) 2416 5160 w (The) 2746 5160 w (fixed-width) 2977 5160 w (font) 3599 5160 w (is) 3846 5160 w (named) 3976 5160 w 10 /LucidaTypewriter f (L) 4355 5160 w 10 /LucidaSansUnicode00 f (\(for) 4477 5160 w (literal\).) 4699 5160 w (Explicit font changes using) 720 5280 w 10 /LucidaTypewriter f (\\f) 2063 5280 w 10 /LucidaSansUnicode00 f (are eschewed in favor of the macros when possible.) 2239 5280 w (Situations) 720 5436 w (often) 1238 5436 w (arise) 1532 5436 w (where) 1805 5436 w (it) 2138 5436 w (is) 2245 5436 w (necessary) 2366 5436 w (to) 2882 5436 w (have) 3021 5436 w (one) 3287 5436 w (part) 3508 5436 w (of) 3746 5436 w (a) 3886 5436 w (word) 3983 5436 w (in) 4267 5436 w (one) 4400 5436 w (font) 4621 5436 w (and) 4860 5436 w (another) 720 5556 w (part) 1130 5556 w (in) 1362 5556 w (another.) 1488 5556 w (For) 1961 5556 w (these) 2152 5556 w (situations,) 2449 5556 w (there) 2990 5556 w (are) 3277 5556 w (several) 3464 5556 w (macros) 3839 5556 w (which) 4226 5556 w (merge) 4542 5556 w (the) 4885 5556 w (words from their text input into a single word, alternating from one font to) 720 5676 w (another) 4401 5676 w (from) 4808 5676 w (word) 720 5796 w (to) 1005 5796 w (word.) 1146 5796 w (For) 1495 5796 w (example,) 1694 5796 w 10 /LucidaTypewriter f (.) 2164 5796 w (IR) 2218 5796 w 10 /LucidaSansUnicode00 f (alternates) 2413 5796 w (between) 2935 5796 w (italic) 3384 5796 w (and) 3656 5796 w (roman.) 3878 5796 w 10 /LucidaTypewriter f (.) 4278 5796 w (BR) 4332 5796 w 10 /LucidaSansUnicode00 f (,) 4484 5796 w 10 /LucidaTypewriter f (.) 4540 5796 w (IB) 4594 5796 w 10 /LucidaSansUnicode00 f (,) 4746 5796 w 10 /LucidaTypewriter f (.) 4802 5796 w (IR) 4856 5796 w 10 /LucidaSansUnicode00 f (,) 5008 5796 w 10 /LucidaTypewriter f (.) 702 5916 w (RB) 756 5916 w 10 /LucidaSansUnicode00 f (,) 908 5916 w (and) 991 5916 w 10 /LucidaTypewriter f (.) 1204 5916 w (RI) 1258 5916 w 10 /LucidaSansUnicode00 f (exhaust) 1461 5916 w (the) 1896 5916 w (remaining) 2102 5916 w (combinations) 2642 5916 w (of) 3347 5916 w (roman,) 3496 5916 w (fixed-width,) 3891 5916 w (and) 4546 5916 w (italic.) 4778 5916 w (There are also) 720 6036 w 10 /LucidaTypewriter f (.) 1424 6036 w (L) 1478 6036 w 10 /LucidaSansUnicode00 f (,) 1558 6036 w 10 /LucidaTypewriter f (.) 1604 6036 w (LR) 1658 6036 w 10 /LucidaSansUnicode00 f (and) 1842 6036 w 10 /LucidaTypewriter f (.) 2036 6036 w (RL) 2090 6036 w 10 /LucidaSansUnicode00 f (macros.) 2274 6036 w (For example,) 720 6192 w 9 /LucidaTypewriter f (.I) 1008 6398 w (Snprint) 1203 6398 w (is) 1008 6508 w (like) 1203 6508 w (.IR) 1008 6618 w (sprint) 1268 6618 w (,) 1723 6618 w (but) 1008 6728 w (will) 1268 6728 w (not) 1593 6728 w (place) 1853 6728 w (more) 2243 6728 w (than) 2568 6728 w (.I) 1008 6838 w (len) 1203 6838 w (bytes) 1008 6948 w (in) 1398 6948 w (.IR) 1008 7058 w (s) 1268 7058 w (.) 1398 7058 w 10 /LucidaSans-Italic f (Snprint) 970 7274 w 10 /LucidaSansUnicode00 f (is like) 1357 7274 w 10 /LucidaSans-Italic f (sprint) 1673 7274 w 10 /LucidaSansUnicode00 f (, but will not place more than) 1960 7274 w 10 /LucidaSans-Italic f (len) 3423 7274 w 10 /LucidaSansUnicode00 f (bytes in) 3599 7274 w 10 /LucidaSans-Italic f (s) 4013 7274 w 10 /LucidaSansUnicode00 f (.) 4062 7274 w cleartomark showpage saveobj restore %%EndPage: 1 1 %%Page: 2 2 /saveobj save def mark 2 pagesetup 10 /LucidaSansUnicode00 f (\255 2 \255) 2783 480 w 9 /LucidaTypewriter f (The) 1008 830 w (numeric) 1268 830 w (verbs) 1788 830 w (.BR) 1008 940 w (d) 1268 940 w (,) 1398 940 w (.BR) 1008 1050 w (o) 1268 1050 w (,) 1398 1050 w (.BR) 1008 1160 w (b) 1268 1160 w (,) 1398 1160 w (.BR) 1008 1270 w (x) 1268 1270 w (,) 1398 1270 w (and) 1008 1380 w (.B) 1008 1490 w (X) 1203 1490 w (format) 1008 1600 w (their) 1463 1600 w (arguments) 1853 1600 w (in) 2503 1600 w (decimal.) 2698 1600 w 10 /LucidaSansUnicode00 f (The numeric verbs) 970 1816 w 10 /LucidaTypewriter f (d) 1904 1816 w 10 /LucidaSansUnicode00 f (,) 1976 1816 w 10 /LucidaTypewriter f (o) 2040 1816 w 10 /LucidaSansUnicode00 f (,) 2112 1816 w 10 /LucidaTypewriter f (b) 2176 1816 w 10 /LucidaSansUnicode00 f (,) 2248 1816 w 10 /LucidaTypewriter f (x) 2312 1816 w 10 /LucidaSansUnicode00 f (, and) 2384 1816 w 10 /LucidaTypewriter f (X) 2660 1816 w 10 /LucidaSansUnicode00 f (format their arguments in decimal.) 2764 1816 w 9 /LucidaTypewriter f (.I) 1008 2022 w (Utflen) 1203 2022 w (returns) 1008 2132 w (the) 1528 2132 w (number) 1788 2132 w (of) 2243 2132 w (runes) 2438 2132 w (that) 2828 2132 w (are) 3153 2132 w (represented) 3413 2132 w (by) 4193 2132 w (the) 4388 2132 w (.SM) 1008 2242 w (UTF) 1268 2242 w (string) 1008 2352 w (.IR) 1008 2462 w (s) 1268 2462 w (.) 1398 2462 w 10 /LucidaSans-Italic f (Utflen) 970 2678 w 10 /LucidaSansUnicode00 f (returns the number of runes that are represented by the) 1291 2678 w 8 /LucidaSansUnicode00 f (UTF) 4058 2678 w 10 /LucidaSansUnicode00 f (string) 4238 2678 w 10 /LucidaSans-Italic f (s) 4552 2678 w 10 /LucidaSansUnicode00 f (.) 4601 2678 w (The) 720 2834 w 10 /LucidaTypewriter f (.) 919 2834 w (SM) 973 2834 w 10 /LucidaSansUnicode00 f (macro) 1161 2834 w (emits) 1498 2834 w (its) 1800 2834 w (arguments) 1953 2834 w (in) 2508 2834 w (smaller) 2635 2834 w (text) 3025 2834 w (and) 3252 2834 w (is) 3468 2834 w (the) 3584 2834 w (usual) 3775 2834 w (method) 4070 2834 w (for) 4479 2834 w (typeset\255) 4655 2834 w (ting all-capital names such as) 720 2954 w 8 /LucidaSansUnicode00 f (UTF) 2209 2954 w 10 /LucidaSansUnicode00 f (,) 2357 2954 w 8 /LucidaSansUnicode00 f (ASCII) 2421 2954 w 10 /LucidaSansUnicode00 f (, and) 2620 2954 w 8 /LucidaSansUnicode00 f (NUL) 2896 2954 w 10 /LucidaSansUnicode00 f (.) 3052 2954 w 10 /LucidaSans-Demi f (Typing Conventions) 720 3194 w 10 /LucidaSansUnicode00 f (Quotation) 720 3350 w (marks) 1243 3350 w (are) 1582 3350 w (written) 1775 3350 w (using) 2155 3350 w (pairs) 2462 3350 w (of) 2742 3350 w (left) 2881 3350 w (and) 3082 3350 w (right) 3304 3350 w (quotes) 3577 3350 w (\() 3949 3350 w 10 /LucidaSansUnicode20 f (\030\030) 3982 3350 w 10 /LucidaSansUnicode00 f (\)) 4046 3350 w (\() 4121 3350 w 10 /LucidaSansUnicode20 f (\031\031) 4154 3350 w 10 /LucidaSansUnicode00 f (\)) 4218 3350 w (rather) 4293 3350 w (than) 4627 3350 w (the) 4885 3350 w (double) 720 3470 w (quotes) 1096 3470 w (\("\).) 1468 3470 w (There) 1677 3470 w (are) 1997 3470 w (three) 2191 3470 w (reasons) 2485 3470 w (for) 2903 3470 w (this.) 3083 3470 w (First,) 3367 3470 w (the) 3652 3470 w (double) 3848 3470 w (quotes) 4223 3470 w (are) 4594 3470 w (often) 4787 3470 w (used) 720 3590 w (to) 991 3590 w (enclose) 1128 3590 w (macro) 1534 3590 w (arguments;) 1875 3590 w (there) 2466 3590 w (is) 2758 3590 w (no) 2878 3590 w (way) 3041 3590 w (to) 3265 3590 w (put) 3403 3590 w (them) 3605 3590 w (inside) 3893 3590 w (such) 4223 3590 w (arguments.) 4489 3590 w (Second,) 720 3710 w (output) 1150 3710 w (on) 1523 3710 w (devices) 1696 3710 w (like) 2104 3710 w (laser) 2326 3710 w (printers) 2608 3710 w (looks) 3038 3710 w (much) 3348 3710 w (better) 3666 3710 w (that) 4006 3710 w (way.) 4247 3710 w (Third,) 4545 3710 w (the) 4885 3710 w (paired-quotes convention) 720 3830 w 10 /LucidaSans-Italic f (is) 2012 3830 w 10 /LucidaSansUnicode00 f (the correct English usage.) 2122 3830 w (The) 720 3986 w (hyphen,) 944 3986 w (the) 1376 3986 w (dash,) 1575 3986 w (and) 1882 3986 w (the) 2106 3986 w (minus) 2305 3986 w (sign) 2646 3986 w (are) 2894 3986 w (three) 3090 3986 w (different) 3386 3986 w (characters,) 3848 3986 w (even) 4424 3986 w (though) 4694 3986 w (most) 720 4106 w (keyboards) 995 4106 w (only) 1528 4106 w (have) 1765 4106 w (one) 2023 4106 w (key) 2235 4106 w (for) 2434 4106 w (all) 2606 4106 w (three.) 2752 4106 w (The) 3101 4106 w (hyphen) 3315 4106 w (is simply) 3705 4106 w 10 /LucidaTypewriter f (-) 4166 4106 w 10 /LucidaSansUnicode00 f (, the dash is) 4238 4106 w 10 /LucidaTypewriter f (\\-) 4864 4106 w 10 /LucidaSansUnicode00 f (,) 5008 4106 w (and) 720 4226 w (the) 937 4226 w (minus) 1129 4226 w (sign) 1463 4226 w (is) 1704 4226 w 10 /LucidaTypewriter f (\\\(em) 1821 4226 w 10 /LucidaSansUnicode00 f (.) 2109 4226 w (In) 2210 4226 w (the) 2338 4226 w (fixed-width) 2530 4226 w (font,) 3139 4226 w (there) 3405 4226 w (is) 3695 4226 w (no) 3813 4226 w (distinction) 3974 4226 w (between) 4523 4226 w 10 /LucidaTypewriter f (-) 4968 4226 w 10 /LucidaSansUnicode00 f (and) 720 4346 w 10 /LucidaTypewriter f (\\-) 932 4346 w 10 /LucidaSansUnicode00 f (and thus no need to use the latter.) 1108 4346 w 10 /LucidaSans-Demi f (Paragraphs) 720 4586 w 10 /LucidaSansUnicode00 f (Text) 720 4742 w (sections) 974 4742 w (are) 1409 4742 w (normally) 1598 4742 w (a) 2057 4742 w (sequence) 2149 4742 w (of) 2643 4742 w (paragraphs.) 2778 4742 w (Simple) 3427 4742 w (paragraphs) 3788 4742 w (are) 4373 4742 w (separated) 4563 4742 w (by) 720 4862 w 10 /LucidaTypewriter f (.) 856 4862 w (PP) 910 4862 w 10 /LucidaSansUnicode00 f (,) 1062 4862 w (which) 1132 4862 w (outputs) 1451 4862 w (a) 1862 4862 w (small) 1955 4862 w (vertical) 2250 4862 w (space,) 2638 4862 w (checks) 2984 4862 w (that) 3351 4862 w (enough) 3580 4862 w (paper) 3983 4862 w (remains) 4299 4862 w (on) 4724 4862 w (the) 4885 4862 w (page) 720 4982 w (for) 1004 4982 w (a) 1191 4982 w (few) 1294 4982 w (more) 1512 4982 w (lines,) 1811 4982 w (and) 2118 4982 w (resets) 2346 4982 w (indents) 2686 4982 w (and) 3094 4982 w (the) 3322 4982 w (like.) 3525 4982 w (The) 3810 4982 w (appearance) 4040 4982 w (of) 4646 4982 w (para\255) 4793 4982 w (graphs) 720 5102 w (produced) 1093 5102 w (by) 1592 5102 w 10 /LucidaTypewriter f (.) 1728 5102 w (PP) 1782 5102 w 10 /LucidaSansUnicode00 f (is) 1973 5102 w (similar) 2092 5102 w (to) 2458 5102 w (that) 2595 5102 w (of) 2825 5102 w (the) 2962 5102 w (paragraphs) 3156 5102 w (you) 3743 5102 w (are) 3957 5102 w (now) 4148 5102 w (reading.) 4386 5102 w (It) 4856 5102 w (is) 4960 5102 w (not necessary to use) 720 5222 w 10 /LucidaTypewriter f (.PP) 1750 5222 w 10 /LucidaSansUnicode00 f (to begin a new paragraph after a subheader \() 1998 5222 w 10 /LucidaTypewriter f (.) 4176 5222 w (SH) 4230 5222 w 10 /LucidaSansUnicode00 f (\).) 4382 5222 w (A) 720 5378 w 10 /LucidaSansUnicode20 f (\030\030) 826 5378 w 10 /LucidaSansUnicode00 f (tagged) 890 5378 w 10 /LucidaSansUnicode20 f (\031\031) 1225 5378 w 10 /LucidaSansUnicode00 f (paragraph) 1326 5378 w (is) 1860 5378 w (one) 1977 5378 w (indented) 2193 5378 w (an) 2659 5378 w (extra) 2814 5378 w (amount) 3102 5378 w (and) 3510 5378 w (preceded) 3728 5378 w (by) 4215 5378 w (a) 4368 5378 w (short) 4461 5378 w 10 /LucidaSans-Italic f (tag) 4751 5378 w 10 /LucidaSansUnicode00 f (in) 4949 5378 w (the) 720 5498 w (space) 926 5498 w (of) 1253 5498 w (the) 1402 5498 w (indent.) 1608 5498 w (Tagged) 2032 5498 w (paragraphs) 2444 5498 w (are) 3043 5498 w (commonly) 3246 5498 w (used) 3799 5498 w (to) 4082 5498 w (discuss) 4231 5498 w (a) 4640 5498 w (list) 4746 5498 w (of) 4942 5498 w (items, such as files or command line options.) 720 5618 w (Each tag is an item.) 2992 5618 w (The) 720 5774 w 10 /LucidaTypewriter f (.) 925 5774 w (TP) 979 5774 w 10 /LucidaSansUnicode00 f (macro) 1173 5774 w (begins) 1516 5774 w (a) 1881 5774 w (tagged) 1978 5774 w (paragraph;) 2355 5774 w (the) 2926 5774 w (first) 3123 5774 w (line) 3360 5774 w (after) 3578 5774 w (it) 3846 5774 w (is) 3954 5774 w (the) 4076 5774 w (tag,) 4273 5774 w (and) 4501 5774 w (subse\255) 4724 5774 w (quent) 720 5894 w (lines) 1048 5894 w (are) 1323 5894 w (the) 1523 5894 w (paragraph) 1726 5894 w (text.) 2271 5894 w (An) 2574 5894 w (optional) 2753 5894 w (argument) 3198 5894 w (to) 3713 5894 w (the) 3858 5894 w 10 /LucidaTypewriter f (.) 4042 5894 w (TP) 4096 5894 w 10 /LucidaSansUnicode00 f (macro) 4295 5894 w (sets) 4643 5894 w (the) 4885 5894 w (amount) 720 6014 w (of) 1123 6014 w (the) 1254 6014 w (indent.) 1442 6014 w (Setting) 1848 6014 w (the) 2219 6014 w (indent) 2408 6014 w (this) 2751 6014 w (way) 2964 6014 w (sets) 3182 6014 w (the) 3411 6014 w (default) 3600 6014 w (for) 3973 6014 w (future) 4146 6014 w 10 /LucidaTypewriter f (.) 4457 6014 w (TP) 4511 6014 w 10 /LucidaSansUnicode00 f (invoca\255) 4697 6014 w (tions.) 720 6134 w (The) 1056 6134 w 10 /LucidaTypewriter f (.) 1251 6134 w (PP) 1305 6134 w 10 /LucidaSansUnicode00 f (macro resets the indent to its default setting.) 1489 6134 w (Explicit) 720 6290 w (indent) 1116 6290 w (lengths) 1468 6290 w (are) 1870 6290 w (rarely) 2065 6290 w (used.) 2382 6290 w (Instead,) 2721 6290 w (the) 3149 6290 w 10 /LucidaTypewriter f (.) 3329 6290 w (TF) 3383 6290 w 10 /LucidaSansUnicode00 f (macro) 3578 6290 w (sets) 3922 6290 w (the) 4160 6290 w 10 /LucidaTypewriter f (.) 4340 6290 w (TP) 4394 6290 w 10 /LucidaSansUnicode00 f (indent) 4589 6290 w (to) 4942 6290 w (the) 720 6410 w (width) 915 6410 w (of) 1223 6410 w (its) 1361 6410 w (argument) 1518 6410 w (plus) 2025 6410 w (two) 2269 6410 w (spaces) 2483 6410 w (in) 2849 6410 w (the) 2979 6410 w (fixed-width) 3173 6410 w (font.) 3784 6410 w (This) 4084 6410 w (is) 4328 6410 w (useful) 4447 6410 w (when) 4783 6410 w (the) 720 6530 w (paragraph) 916 6530 w (tags) 1454 6530 w (are) 1700 6530 w (file) 1893 6530 w (names,) 2085 6530 w (control) 2475 6530 w (messages,) 2858 6530 w (or) 3406 6530 w (other) 3549 6530 w (text) 3848 6530 w (formatted) 4081 6530 w (in) 4603 6530 w (fixed-) 4736 6530 w (width font.) 720 6650 w (A) 720 6806 w (sequence) 829 6806 w (of) 1326 6806 w 10 /LucidaTypewriter f (.) 1446 6806 w (TP) 1500 6806 w 10 /LucidaSansUnicode00 f (paragraphs) 1692 6806 w (must) 2280 6806 w (end) 2563 6806 w (with) 2785 6806 w (a) 3031 6806 w 10 /LucidaTypewriter f (.) 3109 6806 w (PD) 3163 6806 w 10 /LucidaSansUnicode00 f (request) 3356 6806 w (to) 3763 6806 w (restore) 3902 6806 w (the) 4286 6806 w (usual) 4482 6806 w (inter\255) 4782 6806 w (paragraph spacing.) 720 6926 w (For example:) 1718 6926 w cleartomark showpage saveobj restore %%EndPage: 2 2 %%Page: 3 3 /saveobj save def mark 3 pagesetup 10 /LucidaSansUnicode00 f (\255 3 \255) 2783 480 w 9 /LucidaTypewriter f (.TF) 1008 830 w (/adm/users) 1268 830 w (.TP) 1008 940 w (.B) 1008 1050 w (/adm/users) 1203 1050 w (The) 1008 1160 w (user) 1268 1160 w (names) 1593 1160 w (known) 1983 1160 w (to) 2373 1160 w (the) 2568 1160 w (file) 2828 1160 w (server) 3153 1160 w (.TP) 1008 1270 w (.B) 1008 1380 w (/sys/games/lib/fortunes) 1203 1380 w (Pithy) 1008 1490 w (comments) 1398 1490 w (.PD) 1008 1600 w 10 /LucidaTypewriter f (/adm/users) 970 1816 w 10 /LucidaSansUnicode00 f (The user names known to the file server) 1834 1816 w 10 /LucidaTypewriter f (/sys/games/lib/fortunes) 970 1984 w 10 /LucidaSansUnicode00 f (Pithy comments) 1834 2128 w (The) 720 2332 w 10 /LucidaTypewriter f (.IP) 936 2332 w 10 /LucidaSansUnicode00 f (macro) 1187 2332 w (behaves) 1523 2332 w (identically) 1953 2332 w (to) 2480 2332 w 10 /LucidaTypewriter f (.TP) 2613 2332 w 10 /LucidaSansUnicode00 f (,) 2829 2332 w (except) 2896 2332 w (that) 3255 2332 w (its) 3481 2332 w (first) 3633 2332 w (argument) 3863 2332 w (is) 4366 2332 w (the) 4481 2332 w (tag) 4671 2332 w (and) 4860 2332 w (its second \(optional\) argument is the indent distance.) 720 2452 w 10 /LucidaSans-Demi f (Title Heading) 720 2692 w 10 /LucidaSansUnicode00 f (A) 720 2848 w (manual) 825 2848 w (page) 1217 2848 w (consists) 1489 2848 w (of) 1918 2848 w (a) 2052 2848 w (title) 2143 2848 w (heading,) 2367 2848 w (several) 2824 2848 w (subheadings,) 3200 2848 w (and) 3884 2848 w (indented) 4100 2848 w (text) 4565 2848 w (para\255) 4793 2848 w (graphs.) 720 2968 w (The title heading is defined by the) 720 3124 w 10 /LucidaTypewriter f (.TH) 2418 3124 w 10 /LucidaSansUnicode00 f (macro, which takes two arguments:) 2666 3124 w 9 /LucidaTypewriter f (.TH) 1008 3294 w 9 /LucidaSans-Italic f (name) 1232 3294 w (section) 1504 3294 w 10 /LucidaSans-Italic f (Name) 720 3474 w 10 /LucidaSansUnicode00 f (and) 1038 3474 w 10 /LucidaSans-Italic f (section) 1255 3474 w 10 /LucidaSansUnicode00 f (are) 1631 3474 w (the) 1821 3474 w (name) 2014 3474 w (of) 2318 3474 w (the) 2454 3474 w (manual) 2647 3474 w (page) 3041 3474 w (and) 3315 3474 w (the) 3533 3474 w (section) 3726 3474 w (number) 4111 3474 w (in) 4526 3474 w (which) 4655 3474 w (it) 4974 3474 w (appears.) 720 3594 w 10 /LucidaSans-Italic f (Name) 1200 3594 w 10 /LucidaSansUnicode00 f (and) 1513 3594 w 10 /LucidaSans-Italic f (section) 1725 3594 w 10 /LucidaSansUnicode00 f (appear in the top corners of all manual pages.) 2095 3594 w 9 /LucidaTypewriter f (.TH) 1008 3764 w (TROFF) 1268 3764 w (1) 1658 3764 w (.TH) 1008 3874 w (QSORT) 1268 3874 w (2) 1658 3874 w (.TH) 1008 3984 w (MAN) 1268 3984 w (6) 1528 3984 w 10 /LucidaSansUnicode00 f (The) 720 4200 w 10 /LucidaTypewriter f (.) 915 4200 w (TH) 969 4200 w 10 /LucidaSansUnicode00 f (line must be the first in the file.) 1153 4200 w (The) 720 4356 w 10 /LucidaSans-Italic f (name) 949 4356 w 10 /LucidaSansUnicode00 f (argument) 1266 4356 w (to) 1782 4356 w (the) 1928 4356 w 10 /LucidaTypewriter f (.) 2113 4356 w (TH) 2167 4356 w 10 /LucidaSansUnicode00 f (is) 2367 4356 w (usually) 2496 4356 w (the) 2885 4356 w (name) 3089 4356 w (of) 3404 4356 w (the) 3551 4356 w (entity) 3755 4356 w (\(program,) 4077 4356 w (function,) 4607 4356 w (library,) 720 4476 w (etc.\)) 1105 4476 w (being) 1357 4476 w (described.) 1672 4476 w (Sometimes) 2252 4476 w (a) 2825 4476 w (manual) 2923 4476 w (page) 3322 4476 w (describes) 3601 4476 w (several) 4104 4476 w (entities;) 4486 4476 w (in) 4949 4476 w (such) 720 4596 w (cases,) 983 4596 w (the) 1316 4596 w (one) 1508 4596 w (used) 1724 4596 w (as) 1993 4596 w (the) 2136 4596 w (argument) 2328 4596 w (to) 2833 4596 w 10 /LucidaTypewriter f (.) 2950 4596 w (TH) 3004 4596 w 10 /LucidaSansUnicode00 f (is) 3193 4596 w (the) 3310 4596 w (first) 3503 4596 w (one) 3736 4596 w (in) 3953 4596 w (the) 4082 4596 w 9 /LucidaSansUnicode00 f (NAME) 4275 4596 w 10 /LucidaSansUnicode00 f (list) 4568 4596 w (\(to) 4752 4596 w (be) 4921 4596 w (discussed) 720 4716 w (in) 1231 4716 w (a) 1356 4716 w (moment\).) 1445 4716 w (A) 1978 4716 w (manual) 2081 4716 w (page) 2471 4716 w (which) 2741 4716 w (is) 3056 4716 w (not) 3170 4716 w (associated) 3364 4716 w (with) 3906 4716 w (any) 4144 4716 w (particular) 4346 4716 w (pro\255) 4842 4716 w (gram,) 720 4836 w (function,) 1054 4836 w (etc.,) 1538 4836 w (is) 1797 4836 w (named) 1928 4836 w (by) 2308 4836 w (what) 2474 4836 w (it) 2756 4836 w (describes,) 2874 4836 w (preferably) 3419 4836 w (one) 3964 4836 w (short) 4195 4836 w (word) 4499 4836 w (\(e.g.,) 4793 4836 w 10 /LucidaSans-Italic f (booting) 720 4956 w 10 /LucidaSansUnicode00 f (\(8\)\).) 1085 4956 w (The) 720 5112 w 10 /LucidaSans-Italic f (section) 937 5112 w 10 /LucidaSansUnicode00 f (in) 1311 5112 w (the) 1438 5112 w 10 /LucidaTypewriter f (.) 1611 5112 w (TH) 1665 5112 w 10 /LucidaSansUnicode00 f (is) 1853 5112 w (the) 1969 5112 w (manual) 2160 5112 w (section) 2552 5112 w (number.) 2935 5112 w (The) 3412 5112 w (Plan) 3630 5112 w (9) 3868 5112 w (manual) 3968 5112 w (has) 4361 5112 w (eight) 4566 5112 w (sec\255) 4849 5112 w (tions:) 720 5232 w (Section 1) 970 5388 w (General publicly accessible commands) 1639 5388 w (Section 2) 970 5508 w (Library functions, including system calls) 1639 5508 w (Section 3) 970 5628 w (Kernel devices \(accessed via) 1639 5628 w 10 /LucidaSans-Italic f (bind) 3037 5628 w 10 /LucidaSansUnicode00 f (\)) 3250 5628 w (Section 4) 970 5748 w (File services \(accessed via) 1639 5748 w 10 /LucidaSans-Italic f (mount) 2925 5748 w 10 /LucidaSansUnicode00 f (\)) 3237 5748 w (Section 5) 970 5868 w (The Plan 9 file protocol, 9P) 1639 5868 w (Section 6) 970 5988 w (File formats) 1639 5988 w (Section 7) 970 6108 w (Databases and database access programs) 1639 6108 w (Section 8) 970 6228 w (Things related to administering Plan 9) 1639 6228 w (A) 720 6384 w (more) 822 6384 w (detailed) 1106 6384 w (explanation) 1527 6384 w (of) 2130 6384 w (these) 2262 6384 w (chapters) 2558 6384 w (can) 3008 6384 w (be) 3210 6384 w (found) 3363 6384 w (in) 3682 6384 w (the) 3807 6384 w (manual) 3996 6384 w (itself,) 4386 6384 w (specifi\255) 4691 6384 w (cally the) 720 6504 w 10 /LucidaSans-Italic f (intro) 1155 6504 w 10 /LucidaSansUnicode00 f (manual page in each section.) 1421 6504 w (The manual page source is stored in the file) 720 6660 w 10 /LucidaTypewriter f (/sys/man/) 2929 6660 w 10 /LucidaSans-Italic f (section) 3577 6660 w 10 /LucidaTypewriter f (/) 3915 6660 w 10 /LucidaSans-Italic f (name) 3987 6660 w 10 /LucidaTypewriter f (.) 4256 6660 w cleartomark showpage saveobj restore %%EndPage: 3 3 %%Page: 4 4 /saveobj save def mark 4 pagesetup 10 /LucidaSansUnicode00 f (\255 4 \255) 2783 480 w 10 /LucidaSans-Demi f (Page Sections) 720 840 w 10 /LucidaSansUnicode00 f (The sections in a manual page always appear in the following order:) 720 996 w 9 /LucidaSansUnicode00 f (NAME) 970 1152 w (SYNOPSIS) 970 1272 w (DESCRIPTION) 970 1392 w (EXAMPLE) 970 1512 w 10 /LucidaSansUnicode00 f (\(or) 1394 1512 w 9 /LucidaSansUnicode00 f (EXAMPLES) 1558 1512 w 10 /LucidaSansUnicode00 f (\)) 1999 1512 w 9 /LucidaSansUnicode00 f (FILES) 970 1632 w (SOURCE) 970 1752 w (SEE) 970 1872 w (ALSO) 1146 1872 w (DIAGNOSTICS) 970 1992 w (BUGS) 970 2112 w 10 /LucidaSansUnicode00 f (Not) 720 2268 w (every) 942 2268 w (section) 1249 2268 w (is) 1646 2268 w (needed) 1776 2268 w (for) 2182 2268 w (every) 2371 2268 w (manual) 2678 2268 w (page.) 3084 2268 w (The) 3435 2268 w (Plan) 3667 2268 w (9) 3919 2268 w (manual) 4033 2268 w (intentionally) 4440 2268 w (omits) 720 2388 w (many) 1031 2388 w (sections) 1333 2388 w (now) 1771 2388 w (common) 2011 2388 w (on) 2472 2388 w (modern) 2635 2388 w (Unix) 3051 2388 w (systems,) 3312 2388 w (such) 3775 2388 w (as) 4041 2388 w 9 /LucidaSansUnicode00 f (AUTHOR) 4183 2388 w 10 /LucidaSansUnicode00 f (,) 4558 2388 w 9 /LucidaSansUnicode00 f (HISTORY) 4626 2388 w 10 /LucidaSansUnicode00 f (,) 5008 2388 w 9 /LucidaSansUnicode00 f (COPYRIGHT) 720 2508 w 10 /LucidaSansUnicode00 f (, and) 1230 2508 w 9 /LucidaSansUnicode00 f (REPORTING) 1503 2508 w (BUGS) 2030 2508 w 10 /LucidaSansUnicode00 f (.) 2258 2508 w (A) 720 2664 w (section) 823 2664 w (heading) 1204 2664 w (is) 1627 2664 w (given,) 1742 2664 w (and) 2070 2664 w (a) 2285 2664 w (section) 2375 2664 w (begun,) 2757 2664 w (by) 3129 2664 w (a) 3279 2664 w 10 /LucidaTypewriter f (.) 3351 2664 w (SH) 3405 2664 w 10 /LucidaSansUnicode00 f (macro) 3592 2664 w (with) 3928 2664 w (the) 4168 2664 w (heading) 4358 2664 w (as) 4782 2664 w (its) 4923 2664 w (argument.) 720 2784 w (The) 1290 2784 w (header) 1509 2784 w (is) 1880 2784 w (printed) 1998 2784 w (at) 2387 2784 w (the) 2517 2784 w (left) 2710 2784 w (margin;) 2907 2784 w (the) 3319 2784 w (section) 3512 2784 w (is) 3897 2784 w (indented) 4015 2784 w (a) 4481 2784 w (short) 4574 2784 w (dis\255) 4864 2784 w (tance.) 720 2904 w 10 /LucidaSans-Demi f (NAME) 845 3108 w 10 /LucidaSansUnicode00 f (The) 970 3228 w 9 /LucidaSansUnicode00 f (NAME) 1187 3228 w 10 /LucidaSansUnicode00 f (section) 1481 3228 w (is) 1867 3228 w (present) 1986 3228 w (in) 2391 3228 w (every) 2521 3228 w (manual) 2817 3228 w (page.) 3212 3228 w (It) 3552 3228 w (lists) 3658 3228 w (the) 3895 3228 w (exact) 4090 3228 w (names) 4390 3228 w (of) 4747 3228 w (the) 4885 3228 w (things) 970 3348 w (discussed) 1308 3348 w (in) 1820 3348 w (the) 1946 3348 w (entry) 2136 3348 w (followed) 2419 3348 w (by) 2867 3348 w (a) 3017 3348 w (short) 3107 3348 w (description.) 3394 3348 w (If) 4036 3348 w (there) 4137 3348 w (is) 4424 3348 w (more) 4539 3348 w (than) 4824 3348 w (one) 970 3468 w (name,) 1188 3468 w (the) 1525 3468 w (first) 1719 3468 w (should) 1953 3468 w (be) 2320 3468 w (the) 2478 3468 w (one) 2672 3468 w (which) 2890 3468 w (best) 3210 3468 w (evokes) 3456 3468 w (visions) 3829 3468 w (of) 4204 3468 w (the) 4342 3468 w (whole) 4537 3468 w (list,) 4862 3468 w (since) 970 3588 w (that) 1259 3588 w (will) 1490 3588 w (also) 1694 3588 w (be) 1930 3588 w (the) 2089 3588 w (name) 2284 3588 w (of) 2590 3588 w (the) 2728 3588 w (manual) 2923 3588 w (entry) 3319 3588 w (as) 3607 3588 w (a) 3753 3588 w (whole.) 3848 3588 w (\(This) 4237 3588 w (criterion) 4514 3588 w (is) 4960 3588 w (admittedly a bit vague.\)) 970 3708 w (The) 970 3864 w (name\(s\)) 1197 3864 w (\(separated) 1626 3864 w (by) 2182 3864 w (commas\)) 2343 3864 w (are) 2826 3864 w (followed) 3024 3864 w (by) 3483 3864 w (a) 3644 3864 w (minus) 3745 3864 w (sign) 4088 3864 w (\() 4339 3864 w 10 /LucidaTypewriter f (\\-) 4372 3864 w 10 /LucidaSansUnicode00 f (\)) 4516 3864 w (and) 4596 3864 w (then) 4823 3864 w (the) 970 3984 w (description.) 1168 3984 w (Keep) 1818 3984 w (the) 2101 3984 w (description) 2299 3984 w (brief,) 2885 3984 w (less) 3186 3984 w (than) 3416 3984 w (a) 3675 3984 w (line.) 3772 3984 w (Avoid) 4054 3984 w (font) 4370 3984 w (changes,) 4609 3984 w (special) 970 4104 w (symbols,) 1346 4104 w (and) 1820 4104 w (cryptic) 2042 4104 w (buzzwords.) 2408 4104 w (\(The) 3046 4104 w 9 /LucidaSansUnicode00 f (NAME) 3299 4104 w 10 /LucidaSansUnicode00 f (section) 3596 4104 w (is) 3986 4104 w (used) 4109 4104 w (by) 4384 4104 w (other) 4542 4104 w (pro\255) 4842 4104 w (grams,) 970 4224 w (such) 1343 4224 w (as) 1608 4224 w (the) 1753 4224 w (one) 1947 4224 w (which) 2165 4224 w (prepares) 2485 4224 w (the) 2950 4224 w (indices) 3144 4224 w (for) 3523 4224 w (the) 3700 4224 w (manual,) 3893 4224 w (and) 4319 4224 w (those) 4537 4224 w (pro\255) 4842 4224 w (grams) 970 4344 w (do) 1311 4344 w (not) 1474 4344 w (parse) 1673 4344 w (arbitrary) 1978 4344 w 10 /LucidaSans-Italic f (troff) 2431 4344 w 10 /LucidaSansUnicode00 f (input.\)) 2689 4344 w (Examples) 3078 4344 w (\(troff) 3579 4344 w (source,) 3864 4344 w (not) 4257 4344 w (printed) 4456 4344 w (out\255) 4847 4344 w (put\):) 970 4464 w 9 /LucidaTypewriter f (awk) 1008 4634 w (\\-) 1268 4634 w (pattern-directed) 1463 4634 w (scanning) 2568 4634 w (and) 3153 4634 w (processing) 3413 4634 w (language) 4128 4634 w (bind,) 1008 4744 w (mount,) 1398 4744 w (unmount) 1853 4744 w (\\-) 2373 4744 w (change) 2568 4744 w (name) 3023 4744 w (space) 3348 4744 w (calendar) 1008 4854 w (\\-) 1593 4854 w (print) 1788 4854 w (upcoming) 2178 4854 w (events) 2763 4854 w (cmp) 1008 4964 w (\\-) 1268 4964 w (compare) 1463 4964 w (two) 1983 4964 w (files) 2243 4964 w 10 /LucidaSans-Demi f (SYNOPSIS) 845 5192 w 10 /LucidaSansUnicode00 f (Next, on most manual pages, is the) 970 5348 w 9 /LucidaSansUnicode00 f (SYNOPSIS) 2726 5348 w 10 /LucidaSansUnicode00 f (section.) 3174 5348 w (This is absent) 3617 5348 w (only) 4323 5348 w (in) 4560 5348 w (manual) 4684 5348 w (entries) 970 5468 w (not) 1360 5468 w (discussing) 1578 5468 w (identifiable) 2147 5468 w (programs,) 2749 5468 w (functions,) 3305 5468 w (etc.,) 3846 5468 w (but) 4111 5468 w (rather) 4330 5468 w (general) 4679 5468 w (concepts) 970 5588 w (like) 1441 5588 w (booting.) 1652 5588 w (The) 2130 5588 w (rule) 2350 5588 w (is:) 2577 5588 w (if) 2728 5588 w (there) 2833 5588 w (is) 3124 5588 w (any) 3243 5588 w (conceivable) 3452 5588 w (way) 4057 5588 w (to) 4281 5588 w 10 /LucidaTypewriter f (type) 4419 5588 w 10 /LucidaSansUnicode00 f (it,) 4747 5588 w (the) 4885 5588 w (synopsis section should say how.) 970 5708 w (Command synopses use the following notations:) 970 5864 w 10 /LucidaTypewriter f (Fixed-width) 1220 6020 w 10 /LucidaSansUnicode00 f (text is literal, to be typed just as is appears.) 2044 6020 w 10 /LucidaSans-Italic f (Italic) 1220 6176 w 10 /LucidaSansUnicode00 f (text) 1502 6176 w (is) 1739 6176 w (a) 1865 6176 w (placeholder,) 1967 6176 w (indicating) 2612 6176 w (a) 3138 6176 w (place) 3240 6176 w (where) 3541 6176 w (an) 3880 6176 w (argument) 4044 6176 w (such) 4559 6176 w (as) 4832 6176 w (a) 4985 6176 w (number or file name is to be typed.) 1220 6296 w (Square brackets [ ] around something mean that it is optional.) 1220 6452 w (A pipe symbol) 1220 6608 w 10 /LucidaTypewriter f (|) 1945 6608 w 10 /LucidaSansUnicode00 f (between two things indicate that only one should be used.) 2049 6608 w (An ellipsis ) 1220 6764 w 10 /LucidaSansUnicode20 f (\030\030) 1752 6764 w 10 /LucidaSansUnicode00 f (...) 1816 6764 w 10 /LucidaSansUnicode20 f (\031\031) 1912 6764 w 10 /LucidaSansUnicode00 f (means that the previous thing can be repeated.) 2008 6764 w (Because) 970 6920 w (they) 1395 6920 w (are) 1638 6920 w (set) 1826 6920 w (in) 2006 6920 w (fixed-width) 2133 6920 w (font,) 2741 6920 w (command) 3006 6920 w (options) 3521 6920 w (are) 3922 6920 w (typeset) 4111 6920 w (with) 4500 6920 w (a) 4742 6920 w (sim\255) 4834 6920 w (ple hyphen rather than the minus that would be necessary in variable-width fonts.) 970 7040 w (By convention, options) 970 7196 w (without) 2106 7196 w (arguments) 2504 7196 w (are) 3056 7196 w (listed) 3241 7196 w (first) 3539 7196 w (in) 3767 7196 w (a) 3891 7196 w (single) 3979 7196 w (bracketing,) 4301 7196 w (fol\255) 4880 7196 w (lowed by the options taking arguments.) 970 7316 w (Both should usually be alphabetized.) 2968 7316 w cleartomark showpage saveobj restore %%EndPage: 4 4 %%Page: 5 5 /saveobj save def mark 5 pagesetup 10 /LucidaSansUnicode00 f (\255 5 \255) 2783 480 w (For example:) 970 840 w 9 /LucidaTypewriter f (.B) 1008 1010 w (hget) 1203 1010 w ([) 1008 1120 w (.B) 1008 1230 w (-dhv) 1203 1230 w (]) 1008 1340 w ([) 1138 1340 w (.B) 1008 1450 w (-o) 1203 1450 w (.I) 1008 1560 w (ofile) 1203 1560 w (]) 1008 1670 w ([) 1138 1670 w (.B) 1008 1780 w (-p) 1203 1780 w (.I) 1008 1890 w (body) 1203 1890 w (]) 1008 2000 w ([) 1138 2000 w (.B) 1008 2110 w (-x) 1203 2110 w (.I) 1008 2220 w (netmntpt) 1203 2220 w (]) 1008 2330 w (.I) 1008 2440 w (url) 1203 2440 w 10 /LucidaTypewriter f (hget) 1220 2656 w 10 /LucidaSansUnicode00 f ([) 1540 2656 w 10 /LucidaTypewriter f (-dhv) 1605 2656 w 10 /LucidaSansUnicode00 f (] [) 1925 2656 w 10 /LucidaTypewriter f (-o) 2055 2656 w 10 /LucidaSans-Italic f (ofile) 2231 2656 w 10 /LucidaSansUnicode00 f (] [) 2469 2656 w 10 /LucidaTypewriter f (-p) 2599 2656 w 10 /LucidaSans-Italic f (body) 2775 2656 w 10 /LucidaSansUnicode00 f (] [) 3041 2656 w 10 /LucidaTypewriter f (-x) 3171 2656 w 10 /LucidaSans-Italic f (netmntpt) 3347 2656 w 10 /LucidaSansUnicode00 f (]) 3824 2656 w 10 /LucidaSans-Italic f (url) 3889 2656 w 10 /LucidaSansUnicode00 f (The) 970 2812 w (same) 1184 2812 w (sort) 1472 2812 w (of) 1695 2812 w (conventions) 1826 2812 w (apply) 2443 2812 w (to) 2738 2812 w 9 /LucidaSansUnicode00 f (SYNOPSIS) 2869 2812 w 10 /LucidaSansUnicode00 f (sections) 3319 2812 w (for) 3751 2812 w (things) 3924 2812 w (other) 4261 2812 w (than) 4552 2812 w (com\255) 4802 2812 w (mands,) 970 2932 w (although) 1387 2932 w (such) 1878 2932 w (sections) 2165 2932 w (tend) 2623 2932 w (to) 2901 2932 w (use) 3059 2932 w (fixed-width) 3288 2932 w (text) 3920 2932 w (exclusively,) 4171 2932 w (since) 4791 2932 w (there) 970 3052 w (is) 1280 3052 w (seldom) 1418 3052 w (much) 1829 3052 w (choice) 2155 3052 w (about) 2524 3052 w (how) 2861 3052 w (to) 3120 3052 w (call) 3277 3052 w (a) 3500 3052 w (function.) 3614 3052 w (If) 4138 3052 w (a) 4263 3052 w (manual) 4377 3052 w (entry) 4792 3052 w (describes) 970 3172 w (more) 1471 3172 w (than) 1762 3172 w (one) 2018 3172 w (program,) 2237 3172 w (function,) 2725 3172 w (etc.,) 3197 3172 w (the) 3444 3172 w (synopses) 3638 3172 w (are) 4124 3172 w (separated) 4315 3172 w (by) 4831 3172 w (a) 4985 3172 w (paragraph breaks \() 970 3292 w 10 /LucidaTypewriter f (.) 1870 3292 w (PP) 1924 3292 w 10 /LucidaSansUnicode00 f (\).) 2076 3292 w (Synopses) 970 3448 w (in) 1462 3448 w (section) 1595 3448 w (2) 1984 3448 w (begin) 2089 3448 w (with) 2403 3448 w (the) 2650 3448 w 10 /LucidaTypewriter f (#include) 2847 3448 w 10 /LucidaSansUnicode00 f (lines) 3465 3448 w (that) 3734 3448 w (must) 3968 3448 w (be) 4254 3448 w (used) 4416 3448 w (to) 4691 3448 w (load) 4832 3448 w (the given prototypes:) 970 3568 w 9 /LucidaTypewriter f (.B) 1008 3738 w (#include) 1203 3738 w () 1788 3738 w (.br) 1008 3848 w (.B) 1008 3958 w (#include) 1203 3958 w () 1788 3958 w (.PP) 1008 4068 w (.B) 1008 4178 w (int) 1008 4288 w (runetochar\(char) 1528 4288 w (*s,) 2568 4288 w (Rune) 2828 4288 w (*r\)) 3153 4288 w (.PP) 1008 4398 w (.B) 1008 4508 w (int) 1008 4618 w (chartorune\(Rune) 1528 4618 w (*r,) 2568 4618 w (char) 2828 4618 w (*s\)) 3153 4618 w 10 /LucidaTypewriter f (#include ) 1220 4834 w (#include ) 1220 4954 w (int) 1220 5110 w (runetochar\(char *s, Rune *r\)) 1470 5110 w (int) 1220 5266 w (chartorune\(Rune *r, char *s\)) 1470 5266 w 10 /LucidaSans-Demi f (DESCRIPTION) 845 5434 w 10 /LucidaSansUnicode00 f (The) 970 5590 w 9 /LucidaSansUnicode00 f (DESCRIPTION) 1190 5590 w 10 /LucidaSansUnicode00 f (section) 1813 5590 w (is) 2202 5590 w (next) 2324 5590 w (and) 2582 5590 w (is) 2804 5590 w (present) 2926 5590 w (in) 3334 5590 w (all) 3467 5590 w (manual) 3622 5590 w (pages.) 4020 5590 w (It) 4413 5590 w (is) 4521 5590 w (typically) 4643 5590 w (several) 970 5710 w (paragraphs) 1356 5710 w (of) 1950 5710 w (narrative) 2094 5710 w (text) 2568 5710 w (describing) 2805 5710 w (the) 3358 5710 w (details) 3558 5710 w (of) 3923 5710 w (what) 4066 5710 w (goes) 4342 5710 w (on.) 4617 5710 w (It) 4849 5710 w (is) 4960 5710 w (helpful) 970 5830 w (if) 1346 5830 w (the) 1450 5830 w (first) 1643 5830 w (paragraph) 1877 5830 w (is) 2413 5830 w (a) 2532 5830 w (capsule) 2626 5830 w (summary) 3032 5830 w (of) 3518 5830 w (what) 3655 5830 w (the) 3925 5830 w (program) 4119 5830 w (\(function,) 4574 5830 w (etc.\) does and what its inputs and outputs are.) 970 5950 w (Within) 970 6106 w (narrative) 1316 6106 w (text) 1785 6106 w (in) 2017 6106 w (a) 2149 6106 w (manual) 2245 6106 w (entry,) 2642 6106 w (the) 2963 6106 w (basic) 3159 6106 w (rules) 3449 6106 w (are) 3729 6106 w (those) 3922 6106 w (of) 4230 6106 w (good) 4370 6106 w (English:) 4659 6106 w (clarity) 970 6226 w (and) 1305 6226 w (conciseness.) 1526 6226 w (Paragraphs) 2212 6226 w (should) 2793 6226 w (be) 3162 6226 w (short.) 3322 6226 w (Tables,) 3679 6226 w (lists,) 4068 6226 w (etc.) 4337 6226 w (should) 4553 6226 w (be) 4921 6226 w (used) 970 6346 w (whenever) 1239 6346 w (they) 1738 6346 w (make) 1983 6346 w (something) 2283 6346 w (clearer.) 2834 6346 w (Use) 3265 6346 w (the) 3479 6346 w (active) 3672 6346 w (voice.) 3990 6346 w (Omit) 4341 6346 w (needless) 4616 6346 w (words.) 970 6466 w (For further guidance, see) 1359 6466 w 10 /LucidaSans-Italic f (The Elements of Style) 2614 6466 w 10 /LucidaSansUnicode00 f (by Strunk & White.) 3676 6466 w (Frequently) 970 6622 w (a) 1518 6622 w (narrative) 1609 6622 w (has) 2073 6622 w (cause) 2277 6622 w (to) 2588 6622 w (name) 2722 6622 w (programs,) 3024 6622 w (variables,) 3559 6622 w (macros,) 4059 6622 w (etc.,) 4480 6622 w (and) 4725 6622 w (to) 4942 6622 w (reproduce pieces of the) 970 6742 w 9 /LucidaSansUnicode00 f (SYNOPSIS) 2151 6742 w 10 /LucidaSansUnicode00 f (section.) 2599 6742 w (Pieces) 970 6898 w (of) 1338 6898 w (the) 1506 6898 w 9 /LucidaSansUnicode00 f (SYNOPSIS) 1731 6898 w 10 /LucidaSansUnicode00 f (are) 2217 6898 w (reproduced) 2439 6898 w (as) 3066 6898 w (they) 3243 6898 w (occurred,) 3521 6898 w (complete) 4050 6898 w (with) 4567 6898 w (font) 4843 6898 w (changes;) 970 7018 w (the) 1464 7018 w (same) 1682 7018 w (applies) 2000 7018 w (to) 2409 7018 w (any) 2570 7018 w (place) 2802 7018 w (where) 3119 7018 w (a) 3474 7018 w (similar) 3592 7018 w (notation) 3982 7018 w (is) 4448 7018 w (useful) 4590 7018 w (in) 4949 7018 w (expanding on what is meant by something mentioned in the synopsis.) 970 7138 w (There) 970 7294 w (is) 1287 7294 w (one) 1406 7294 w (exception) 1624 7294 w (to) 2139 7294 w (this:) 2276 7294 w (names) 2526 7294 w (of) 2882 7294 w (programs,) 3020 7294 w (functions,) 3559 7294 w (files,) 4083 7294 w (and) 4357 7294 w (variables,) 4577 7294 w cleartomark showpage saveobj restore %%EndPage: 5 5 %%Page: 6 6 /saveobj save def mark 6 pagesetup 10 /LucidaSansUnicode00 f (\255 6 \255) 2783 480 w (even) 970 840 w (the) 1242 840 w (ones) 1443 840 w (described) 1718 840 w (in) 2236 840 w (the) 2372 840 w (synopsis,) 2572 840 w (are) 3069 840 w (treated) 3266 840 w (like) 3656 840 w (foreign) 3873 840 w (words:) 4266 840 w (they) 4636 840 w (are) 4888 840 w (written in italics.) 970 960 w (Such names are capitalized) 1841 960 w (when) 3192 960 w (they) 3482 960 w (occur) 3722 960 w (at) 4021 960 w (the) 4146 960 w (beginning) 4334 960 w (of) 4854 960 w (a) 4985 960 w (sentence.) 970 1080 w (The) 1503 1080 w 10 /LucidaSansUnicode20 f (\030\030) 1722 1080 w 10 /LucidaSansUnicode00 f (italics) 1786 1080 w 10 /LucidaSansUnicode20 f (\031\031) 2067 1080 w 10 /LucidaSansUnicode00 f (rule) 2169 1080 w (applies) 2395 1080 w (even) 2778 1080 w (to) 3041 1080 w (name-and-chapter) 3176 1080 w (manual) 4140 1080 w (references) 4533 1080 w (in) 970 1200 w (the) 1110 1200 w (text:) 1314 1200 w (within) 1586 1200 w (a) 1931 1200 w 9 /LucidaSansUnicode00 f (DESCRIPTION) 2032 1200 w 10 /LucidaSansUnicode00 f (section,) 2662 1200 w (the) 3090 1200 w (proper) 3294 1200 w (way) 3668 1200 w (to) 3902 1200 w (refer) 4050 1200 w (to) 4331 1200 w (the) 4479 1200 w (manual) 4684 1200 w (entry for, say, the mail program, is) 970 1320 w 10 /LucidaSans-Italic f (mail) 2692 1320 w 10 /LucidaSansUnicode00 f (\(1\).) 2904 1320 w (References) 970 1476 w (to) 1545 1476 w (programs) 1689 1476 w (or) 2203 1476 w (functions) 2352 1476 w (documented) 2851 1476 w (on) 3502 1476 w (pages) 3672 1476 w (with) 4006 1476 w (different) 4258 1476 w (names) 4723 1476 w (should give the page reference as a parenthetical, as in:) 970 1596 w 9 /LucidaTypewriter f (The) 1008 1766 w (type) 1268 1766 w (of) 1593 1766 w (compression) 1788 1766 w (is) 2568 1766 w (inferred) 2763 1766 w (from) 3348 1766 w (the) 3673 1766 w (file) 3933 1766 w (name) 4258 1766 w (extension:) 4583 1766 w (.I) 1008 1876 w (bzip2) 1203 1876 w (\(see) 1008 1986 w (.IR) 1008 2096 w (gzip) 1268 2096 w (\(1\)\)) 1593 2096 w (for) 1008 2206 w (.BR) 1008 2316 w (.tar.bz) 1268 2316 w (,) 1788 2316 w (.BR) 1008 2426 w (.tbz) 1268 2426 w (,) 1593 2426 w (.BR) 1008 2536 w (.tar.bz2) 1268 2536 w (,) 1853 2536 w (and) 1008 2646 w (.BR) 1008 2756 w (.tbz2) 1268 2756 w (.) 1658 2756 w 10 /LucidaSansUnicode00 f (The) 720 2972 w (exact) 942 2972 w (reference) 1243 2972 w (to) 1740 2972 w 10 /LucidaSans-Italic f (gzip) 1879 2972 w 10 /LucidaSansUnicode00 f (\(1\),) 2084 2972 w (as) 2286 2972 w (compared) 2433 2972 w (with) 2957 2972 w (a) 3203 2972 w (reference) 3299 2972 w (to) 3796 2972 w (the) 3935 2972 w (non-existent) 4131 2972 w (page) 4804 2972 w 10 /LucidaSans-Italic f (bzip2) 720 3092 w 10 /LucidaSansUnicode00 f (\(1\), creates a valid hyperlink in the HTML version of the manual.) 988 3092 w (Constants,) 720 3248 w 10 /LucidaSans-Italic f (troff) 1277 3248 w 10 /LucidaSansUnicode00 f (macros,) 1536 3248 w (file) 1960 3248 w (names,) 2151 3248 w (and) 2540 3248 w (shell) 2760 3248 w (environment) 3027 3248 w (variables) 3678 3248 w (are) 4149 3248 w (generally) 4341 3248 w (writ\255) 4823 3248 w (ten in fixed-width font.) 720 3368 w 10 /LucidaSans-Demi f (EXAMPLE) 845 3536 w 10 /LucidaSansUnicode00 f (An) 970 3692 w 9 /LucidaSansUnicode00 f (EXAMPLE) 1160 3692 w 10 /LucidaSansUnicode00 f (section) 1614 3692 w (can) 2023 3692 w (be) 2253 3692 w (helpful) 2434 3692 w (when) 2834 3692 w (something) 3153 3692 w (\(especially) 3728 3692 w (some) 4295 3692 w (common) 4619 3692 w (usage\) is tricky or non-obvious.) 970 3812 w (Avoid) 970 3968 w (verbosity:) 1279 3968 w (one) 1820 3968 w (of) 2034 3968 w (the) 2167 3968 w (major) 2357 3968 w (virtues) 2672 3968 w (of) 3035 3968 w (the) 3168 3968 w 9 /LucidaSansUnicode00 f (UNIX) 3358 3968 w 10 /LucidaSansUnicode00 f (and) 3605 3968 w (Plan) 3820 3968 w (9) 4056 3968 w (manual) 4154 3968 w (style) 4546 3968 w (is) 4807 3968 w (its) 4923 3968 w (compactness.) 970 4088 w (If there is more than one example, name the section) 1697 4088 w 9 /LucidaSansUnicode00 f (EXAMPLES) 4271 4088 w 10 /LucidaSansUnicode00 f (.) 4712 4088 w 10 /LucidaSans-Demi f (FILES) 845 4256 w 10 /LucidaSansUnicode00 f (The) 970 4412 w 9 /LucidaSansUnicode00 f (FILES) 1180 4412 w 10 /LucidaSansUnicode00 f (section gives the names of) 1433 4412 w (the) 2761 4412 w (files) 2949 4412 w (which) 3184 4412 w (are) 3498 4412 w (built) 3683 4412 w (into) 3936 4412 w (the) 4158 4412 w (program.) 4346 4412 w (The) 4859 4412 w (names) 970 4532 w (are) 1325 4532 w (generally) 1515 4532 w (given) 1995 4532 w (one) 2294 4532 w (to) 2511 4532 w (a) 2647 4532 w (line,) 2740 4532 w (with) 2985 4532 w (a) 3227 4532 w (comment) 3319 4532 w (following) 3809 4532 w (indicating) 4293 4532 w (what) 4809 4532 w (the) 970 4652 w (file) 1163 4652 w 10 /LucidaSansUnicode20 f (\031) 1314 4652 w 10 /LucidaSansUnicode00 f (s) 1346 4652 w (significance) 1435 4652 w (is.) 2048 4652 w (The) 2231 4652 w (list) 2451 4652 w (is) 2636 4652 w (often) 2755 4652 w (formatted) 3047 4652 w (using) 3566 4652 w (tagged) 3871 4652 w (paragraphs,) 4245 4652 w (dis\255) 4864 4652 w (cussed above.) 970 4772 w 10 /LucidaSans-Demi f (SOURCE) 845 4940 w 10 /LucidaSansUnicode00 f (The) 970 5096 w 9 /LucidaSansUnicode00 f (SOURCE) 1187 5096 w 10 /LucidaSansUnicode00 f (section) 1575 5096 w (names) 1961 5096 w (the) 2318 5096 w (source) 2513 5096 w (files) 2875 5096 w (\(or) 3117 5096 w (directory\)) 3292 5096 w (providing) 3796 5096 w (each) 4298 5096 w (command) 4562 5096 w (or function.) 970 5216 w 9 /LucidaTypewriter f (.SH) 1008 5386 w (SOURCE) 1268 5386 w (.B) 1008 5496 w (/sys/src/9/port/devcons.c) 1203 5496 w 10 /LucidaSans-Demi f (SEE ALSO) 845 5724 w 10 /LucidaSansUnicode00 f (The) 970 5880 w 9 /LucidaSansUnicode00 f (SEE) 1196 5880 w (ALSO) 1388 5880 w 10 /LucidaSansUnicode00 f (section) 1665 5880 w (gives) 2060 5880 w (pointers) 2359 5880 w (to) 2808 5880 w (related) 2955 5880 w (information,) 3341 5880 w (usually) 3989 5880 w (other) 4378 5880 w (manual) 4684 5880 w (pages) 970 6000 w (but) 1292 6000 w (sometimes) 1489 6000 w (external) 2051 6000 w (documents) 2483 6000 w (as) 3054 6000 w (well.) 3195 6000 w (Manual) 3485 6000 w (page) 3869 6000 w (references) 4140 6000 w (are) 4682 6000 w (for\255) 4868 6000 w (matted) 970 6120 w (in) 1351 6120 w (italics,) 1483 6120 w (as) 1837 6120 w (discussed) 1984 6120 w (above.) 2502 6120 w (A) 2894 6120 w (list) 3004 6120 w (of) 3191 6120 w (references) 3330 6120 w (should) 3878 6120 w (be) 4247 6120 w (separated) 4407 6120 w (by) 4925 6120 w (commas.) 970 6240 w cleartomark showpage saveobj restore %%EndPage: 6 6 %%Page: 7 7 /saveobj save def mark 7 pagesetup 10 /LucidaSansUnicode00 f (\255 7 \255) 2783 480 w 9 /LucidaTypewriter f (.SH) 1008 830 w (SEE) 1268 830 w (ALSO) 1528 830 w (.IR) 1008 940 w (ed) 1268 940 w (\(1\),) 1463 940 w (.IR) 1008 1050 w (sed) 1268 1050 w (\(1\),) 1528 1050 w (.IR) 1008 1160 w (grep) 1268 1160 w (\(1\),) 1593 1160 w (.IR) 1008 1270 w (rio) 1268 1270 w (\(1\),) 1528 1270 w (.IR) 1008 1380 w (regexp) 1268 1380 w (\(6\)) 1723 1380 w (.PP) 1008 1490 w (Rob) 1008 1600 w (Pike,) 1268 1600 w (``The) 1008 1710 w (text) 1398 1710 w (editor) 1723 1710 w (sam''.) 2178 1710 w 10 /LucidaSans-Demi f (DIAGNOSTICS) 845 1938 w 10 /LucidaSansUnicode00 f (The) 970 2094 w 9 /LucidaSansUnicode00 f (DIAGNOSTICS) 1184 2094 w 10 /LucidaSansUnicode00 f (section) 1821 2094 w (explains) 2204 2094 w (diagnostics) 2646 2094 w (such) 3233 2094 w (as) 3495 2094 w (the) 3637 2094 w (exit) 3828 2094 w (status) 4047 2094 w (of) 4376 2094 w (commands) 4511 2094 w (or) 970 2214 w (the) 1106 2214 w (return) 1295 2214 w (value) 1628 2214 w (of) 1916 2214 w (functions.) 2048 2214 w (If) 2598 2214 w (the) 2698 2214 w (diagnostics) 2887 2214 w (are) 3472 2214 w (considered) 3658 2214 w (to) 4225 2214 w (be) 4356 2214 w (sufficiently) 4508 2214 w (explained in the description, this section is omitted.) 970 2334 w 9 /LucidaTypewriter f (.SH) 1008 2504 w (DIAGNOSTICS) 1268 2504 w (If) 1008 2614 w (.I) 1008 2724 w (echo) 1203 2724 w (draws) 1008 2834 w (an) 1398 2834 w (error) 1593 2834 w (while) 1983 2834 w (writing) 2373 2834 w (to) 2893 2834 w (standard) 3088 2834 w (output,) 3673 2834 w (the) 1008 2944 w (exit) 1268 2944 w (status) 1593 2944 w (is) 2048 2944 w (.LR) 1008 3054 w ("write) 1268 3054 w (error") 1723 3054 w (.) 2178 3054 w (Otherwise) 1008 3164 w (the) 1658 3164 w (exit) 1918 3164 w (status) 2243 3164 w (is) 2698 3164 w (empty.) 2893 3164 w (.SH) 1008 3394 w (DIAGNOSTICS) 1268 3394 w (.I) 1008 3504 w (Abs) 1203 3504 w (and) 1008 3614 w (.I) 1008 3724 w (labs) 1203 3724 w (return) 1008 3834 w (the) 1008 3944 w (most) 1268 3944 w (negative) 1593 3944 w (integer) 2178 3944 w (or) 2698 3944 w (long) 2893 3944 w (when) 1008 4054 w (the) 1333 4054 w (true) 1593 4054 w (result) 1918 4054 w (is) 2373 4054 w (unrepresentable.) 2568 4054 w 10 /LucidaSans-Demi f (BUGS) 845 4282 w 10 /LucidaSansUnicode00 f (The) 970 4438 w 9 /LucidaSansUnicode00 f (BUGS) 1181 4438 w 10 /LucidaSansUnicode00 f (section) 1442 4438 w (briefly) 1822 4438 w (lists) 2162 4438 w (shortcomings) 2392 4438 w (or) 3086 4438 w (other) 3222 4438 w 10 /LucidaSansUnicode20 f (\030\030) 3513 4438 w 10 /LucidaSansUnicode00 f (gotchas) 3577 4438 w 10 /LucidaSansUnicode20 f (\031\031) 3956 4438 w 10 /LucidaSansUnicode00 f (that) 4054 4438 w (the) 4279 4438 w (user) 4468 4438 w (should) 4712 4438 w (be) 970 4558 w (aware) 1122 4558 w (of) 1439 4558 w (when using the program.) 1570 4558 w (This is the place to mention things which are) 2856 4558 w (unsatisfactory or tricky about the program, even if) 970 4678 w (it) 3451 4678 w (is) 3550 4678 w (not) 3663 4678 w (clear) 3856 4678 w (that) 4121 4678 w (they) 4345 4678 w (are) 4585 4678 w (bugs.) 4770 4678 w (Mentioning something in a) 970 4798 w 9 /LucidaSansUnicode00 f (BUGS) 2300 4798 w 10 /LucidaSansUnicode00 f (section does not imply a commitment to fix it.) 2560 4798 w 9 /LucidaTypewriter f (.SH) 1008 4968 w (BUGS) 1268 4968 w (.I) 1008 5078 w (Bundle) 1203 5078 w (will) 1008 5188 w (not) 1333 5188 w (create) 1593 5188 w (directories) 2048 5188 w (and) 2828 5188 w (is) 3088 5188 w (unsatisfactory) 1008 5298 w (for) 1983 5298 w (non-text) 2243 5298 w (files.) 2828 5298 w (.PP) 1008 5408 w (Beware) 1008 5518 w (of) 1463 5518 w (gift) 1658 5518 w (horses.) 1983 5518 w 10 /LucidaSansUnicode00 f (In) 720 5734 w (general,) 846 5734 w (if) 1274 5734 w (in) 1375 5734 w (doubt) 1501 5734 w (as) 1822 5734 w (to) 1963 5734 w (how) 2096 5734 w (to) 2331 5734 w (format) 2464 5734 w (something,) 2823 5734 w (it) 3403 5734 w (is) 3504 5734 w (better) 3620 5734 w (to) 3946 5734 w (look) 4080 5734 w (for) 4325 5734 w (an) 4500 5734 w (existing) 4653 5734 w (manual) 720 5854 w (page) 1121 5854 w (and) 1402 5854 w (imitate) 1627 5854 w (it) 2008 5854 w (than) 2119 5854 w (to) 2380 5854 w (invent) 2523 5854 w (a) 2865 5854 w (new) 2964 5854 w (and) 3203 5854 w (unique) 3427 5854 w (style.) 3805 5854 w (Standardization) 4138 5854 w (of) 4942 5854 w (style is a strong aid to readability.) 720 5974 w 10 /LucidaSans-Demi f (Formatting the Manual) 720 6214 w 10 /LucidaSansUnicode00 f (Once) 720 6370 w (a) 1014 6370 w (manual) 1116 6370 w (page) 1519 6370 w (has) 1803 6370 w (been) 2019 6370 w (installed,) 2304 6370 w (it) 2795 6370 w (can) 2909 6370 w (be) 3125 6370 w (displayed) 3292 6370 w (with) 3801 6370 w 10 /LucidaSans-Italic f (man) 4054 6370 w 10 /LucidaSansUnicode00 f (\(1\).) 4270 6370 w (By) 4511 6370 w (default,) 4669 6370 w 10 /LucidaSans-Italic f (man) 720 6490 w 10 /LucidaSansUnicode00 f (prints) 976 6490 w (the) 1299 6490 w (manual) 1494 6490 w (page) 1890 6490 w (as) 2166 6490 w (text.) 2311 6490 w (The) 2605 6490 w 10 /LucidaTypewriter f (-P) 2825 6490 w 10 /LucidaSansUnicode00 f (option) 3008 6490 w (instructs) 3360 6490 w 10 /LucidaSans-Italic f (man) 3820 6490 w 10 /LucidaSansUnicode00 f (to) 4075 6490 w (typeset) 4212 6490 w (the) 4603 6490 w (man\255) 4797 6490 w (ual page and display it in) 720 6610 w 10 /LucidaSans-Italic f (page) 1973 6610 w 10 /LucidaSansUnicode00 f (\(1\), the PostScript viewer.) 2209 6610 w (Before the manual page is installed, it can be displayed by invoking) 720 6766 w 10 /LucidaSans-Italic f (troff) 4027 6766 w 10 /LucidaSansUnicode00 f (directly:) 4278 6766 w 9 /LucidaTypewriter f (troff) 1008 6936 w (-man) 1398 6936 w (file) 1723 6936 w (|) 2048 6936 w (page) 2178 6936 w (nroff) 1008 7046 w (-man) 1398 7046 w (file) 1723 7046 w (troff) 1008 7156 w (-man) 1398 7156 w (file) 1723 7156 w (|) 2048 7156 w (lp) 2178 7156 w cleartomark showpage saveobj restore %%EndPage: 7 7 %%Page: 8 8 /saveobj save def mark 8 pagesetup 10 /LucidaSansUnicode00 f (\255 8 \255) 2783 480 w 10 /LucidaSans-Demi f (Complete Examples) 720 840 w 10 /LucidaSansUnicode00 f (The appendices show the source) 720 996 w (and) 2339 996 w (final) 2552 996 w (typeset) 2797 996 w (versions) 3182 996 w (of) 3618 996 w 10 /LucidaSans-Italic f (src) 3749 996 w 10 /LucidaSansUnicode00 f (\(1\)) 3896 996 w (and) 4058 996 w 10 /LucidaSans-Italic f (pipe) 4271 996 w 10 /LucidaSansUnicode00 f (\(2\)) 4475 996 w (as) 4637 996 w (refer\255) 4776 996 w (ence examples.) 720 1116 w (The entire manual is a good source of further examples.) 1537 1116 w cleartomark showpage saveobj restore %%EndPage: 8 8 %%Page: 9 9 /saveobj save def mark 9 pagesetup 10 /LucidaSans-Typewriter83 f (/sys/man/1/src) 720 470 w (.TH SRC 1) 720 830 w (.SH NAME) 720 940 w (src) 720 1050 w 10 /LucidaSansUnicode20 f (\023) 970 1050 w 10 /LucidaSans-Typewriter83 f (find source code for executable) 1070 1050 w (.SH SYNOPSIS) 720 1160 w (.B src) 720 1270 w ([) 720 1380 w (.B -n) 720 1490 w (]) 720 1600 w ([) 720 1710 w (.B -s) 720 1820 w (.I symbol) 720 1930 w (]) 720 2040 w (.I file) 720 2150 w (.B ...) 720 2260 w (.SH DESCRIPTION) 720 2370 w (.I Src) 720 2480 w (examines the named) 720 2590 w (.I files) 720 2700 w (to find the corresponding source code,) 720 2810 w (which is then sent to the editor using) 720 2920 w (.B B) 720 3030 w (\(see) 720 3140 w (.IR sam \(1\)\).) 720 3250 w (If) 720 3360 w (.I file) 720 3470 w (is an) 720 3580 w (.IR rc \(1\)) 720 3690 w (script, the source is the file itself.) 720 3800 w (If) 720 3910 w (.I file) 720 4020 w (is an executable, the source is defined) 720 4130 w (to be the single file containing the) 720 4240 w (definition of) 720 4350 w (.B main) 720 4460 w (and) 720 4570 w (.I src) 720 4680 w (will point the editor at the line that) 720 4790 w (begins the definition.) 720 4900 w (.I Src) 720 5010 w (uses) 720 5120 w (.IR db \(1\)) 720 5230 w (to extract the symbol table information) 720 5340 w (that identifies the source.) 720 5450 w (.PP) 720 5560 w (.I Src) 720 5670 w (looks for each) 720 5780 w (.I file) 720 5890 w (in the current directory, in) 720 6000 w (.BR /bin ,) 720 6110 w (and in the subdirectories of) 720 6220 w (.BR /bin ,) 720 6330 w (in that order.) 720 6440 w (.PP) 720 6550 w (The) 720 6660 w (.B -n) 720 6770 w (flag causes) 720 6880 w (.B src) 720 6990 w (to print the file name but not send it) 720 7100 w (to the editor.) 720 7210 w (The) 3150 830 w (.B -s) 3150 940 w (flag identifies a) 3150 1050 w (.I symbol) 3150 1160 w (other than) 3150 1270 w (.B main) 3150 1380 w (to locate.) 3150 1490 w (.SH EXAMPLES) 3150 1600 w (Find the source to the) 3150 1710 w (.B main) 3150 1820 w (routine in) 3150 1930 w (.BR /bin/ed :) 3150 2040 w (.IP) 3150 2150 w (.EX) 3150 2260 w (src ed) 3150 2370 w (.EE) 3150 2480 w (.PP) 3150 2590 w (Find the source for) 3150 2700 w (.BR strcmp :) 3150 2810 w (.IP) 3150 2920 w (.EX) 3150 3030 w (src -s strcmp rc) 3150 3140 w (.EE) 3150 3250 w (.SH SOURCE) 3150 3360 w (.B /rc/bin/src) 3150 3470 w (.SH SEE ALSO) 3150 3580 w (.IR db \(1\),) 3150 3690 w (.IR plumb \(1\),) 3150 3800 w (.IR sam \(1\).) 3150 3910 w cleartomark showpage saveobj restore %%EndPage: 9 9 %%Page: 10 10 /saveobj save def mark 10 pagesetup 9 /LucidaSansUnicode00 f (SRC) 720 440 w (\() 895 440 w (1) 932 440 w (\)) 996 440 w (SRC) 5094 440 w (\() 5269 440 w (1) 5306 440 w (\)) 5370 440 w 9 /LucidaSans-Demi f (NAME) 720 1034 w 9 /LucidaSansUnicode00 f (src) 1044 1144 w 9 /LucidaSansUnicode20 f (\023) 1231 1144 w 9 /LucidaSansUnicode00 f (find) 1305 1144 w (source) 1506 1144 w (code) 1825 1144 w (for) 2062 1144 w (executable) 2216 1144 w 9 /LucidaSans-Demi f (SYNOPSIS) 720 1298 w 9 /LucidaTypewriter f (src) 1044 1408 w 9 /LucidaSansUnicode00 f ([) 1268 1408 w 9 /LucidaTypewriter f (-n) 1327 1408 w 9 /LucidaSansUnicode00 f (]) 1486 1408 w ([) 1545 1408 w 9 /LucidaTypewriter f (-s) 1604 1408 w 9 /LucidaSans-Italic f (symbol) 1763 1408 w 9 /LucidaSansUnicode00 f (]) 2102 1408 w 9 /LucidaSans-Italic f (file) 2161 1408 w 9 /LucidaTypewriter f (...) 2324 1408 w 9 /LucidaSans-Demi f (DESCRIPTION) 720 1562 w 9 /LucidaSans-Italic f (Src) 1044 1672 w 9 /LucidaSansUnicode00 f (examines) 1213 1672 w (the) 1661 1672 w (named) 1831 1672 w 9 /LucidaSans-Italic f (files) 2159 1672 w 9 /LucidaSansUnicode00 f (to) 2368 1672 w (find) 2487 1672 w (the) 2690 1672 w (corresponding) 2860 1672 w (source) 3525 1672 w (code,) 3846 1672 w (which) 4114 1672 w (is) 4398 1672 w (then) 4502 1672 w (sent) 4729 1672 w (to) 4946 1672 w (the) 5066 1672 w (edi\255) 5237 1672 w (tor) 1044 1782 w (using) 1213 1782 w 9 /LucidaTypewriter f (B) 1497 1782 w 9 /LucidaSansUnicode00 f (\(see) 1606 1782 w 9 /LucidaSans-Italic f (sam) 1826 1782 w 9 /LucidaSansUnicode00 f (\(1\)\).) 2016 1782 w (If) 2236 1782 w 9 /LucidaSans-Italic f (file) 2339 1782 w 9 /LucidaSansUnicode00 f (is) 2517 1782 w (an) 2633 1782 w 9 /LucidaSans-Italic f (rc) 2783 1782 w 9 /LucidaSansUnicode00 f (\(1\)) 2878 1782 w (script,) 3039 1782 w (the) 3357 1782 w (source) 3540 1782 w (is) 3874 1782 w (the) 3990 1782 w (file) 4173 1782 w (itself.) 4352 1782 w (If) 4668 1782 w 9 /LucidaSans-Italic f (file) 4771 1782 w 9 /LucidaSansUnicode00 f (is) 4949 1782 w (an) 5065 1782 w (exe\255) 5215 1782 w (cutable,) 1044 1892 w (the) 1428 1892 w (source) 1604 1892 w (is) 1931 1892 w (defined) 2041 1892 w (to) 2408 1892 w (be) 2534 1892 w (the) 2679 1892 w (single) 2856 1892 w (file) 3154 1892 w (containing) 3327 1892 w (the) 3825 1892 w (definition) 4002 1892 w (of) 4458 1892 w 9 /LucidaTypewriter f (main) 4584 1892 w 9 /LucidaSansUnicode00 f (and) 4882 1892 w 9 /LucidaSans-Italic f (src) 5083 1892 w 9 /LucidaSansUnicode00 f (will) 5253 1892 w (point) 1044 2002 w (the) 1309 2002 w (editor) 1486 2002 w (at) 1782 2002 w (the) 1903 2002 w (line) 2080 2002 w (that) 2276 2002 w (begins) 2486 2002 w (the) 2815 2002 w (definition.) 2992 2002 w 9 /LucidaSans-Italic f (Src) 3506 2002 w 9 /LucidaSansUnicode00 f (uses) 3682 2002 w 9 /LucidaSans-Italic f (db) 3918 2002 w 9 /LucidaSansUnicode00 f (\(1\)) 4035 2002 w (to) 4190 2002 w (extract) 4315 2002 w (the) 4656 2002 w (symbol) 4832 2002 w (table) 5184 2002 w (information) 1044 2112 w (that) 1584 2112 w (identifies) 1785 2112 w (the) 2217 2112 w (source.) 2385 2112 w 9 /LucidaSans-Italic f (Src) 1044 2266 w 9 /LucidaSansUnicode00 f (looks) 1213 2266 w (for) 1478 2266 w (each) 1634 2266 w 9 /LucidaSans-Italic f (file) 1867 2266 w 9 /LucidaSansUnicode00 f (in) 2032 2266 w (the) 2145 2266 w (current) 2315 2266 w (directory,) 2661 2266 w (in) 3109 2266 w 9 /LucidaTypewriter f (/bin) 3222 2266 w 9 /LucidaSansUnicode00 f (,) 3482 2266 w (and) 3542 2266 w (in) 3736 2266 w (the) 3849 2266 w (subdirectories) 4019 2266 w (of) 4673 2266 w 9 /LucidaTypewriter f (/bin) 4793 2266 w 9 /LucidaSansUnicode00 f (,) 5053 2266 w (in) 5114 2266 w (that) 5228 2266 w (order.) 1044 2376 w (The) 1044 2530 w 9 /LucidaTypewriter f (-n) 1238 2530 w 9 /LucidaSansUnicode00 f (flag) 1399 2530 w (causes) 1595 2530 w 9 /LucidaTypewriter f (src) 1920 2530 w 9 /LucidaSansUnicode00 f (to) 2147 2530 w (print) 2267 2530 w (the) 2508 2530 w (file) 2679 2530 w (name) 2846 2530 w (but) 3118 2530 w (not) 3296 2530 w (send) 3472 2530 w (it) 3713 2530 w (to) 3804 2530 w (the) 3924 2530 w (editor.) 4095 2530 w (The) 4443 2530 w 9 /LucidaTypewriter f (-s) 4638 2530 w 9 /LucidaSansUnicode00 f (flag) 4800 2530 w (identifies) 4997 2530 w (a) 1044 2640 w 9 /LucidaSans-Italic f (symbol) 1123 2640 w 9 /LucidaSansUnicode00 f (other) 1462 2640 w (than) 1722 2640 w 9 /LucidaTypewriter f (main) 1946 2640 w 9 /LucidaSansUnicode00 f (to) 2235 2640 w (locate.) 2352 2640 w 9 /LucidaSans-Demi f (EXAMPLES) 720 2794 w 9 /LucidaSansUnicode00 f (Find) 1044 2904 w (the) 1261 2904 w (source) 1429 2904 w (to) 1748 2904 w (the) 1865 2904 w 9 /LucidaTypewriter f (main) 2033 2904 w 9 /LucidaSansUnicode00 f (routine) 2322 2904 w (in) 2664 2904 w 9 /LucidaTypewriter f (/bin/ed) 2775 2904 w 9 /LucidaSansUnicode00 f (:) 3230 2904 w 9 /LucidaTypewriter f (src) 1368 3058 w (ed) 1628 3058 w 9 /LucidaSansUnicode00 f (Find) 1044 3212 w (the) 1261 3212 w (source) 1429 3212 w (for) 1748 3212 w 9 /LucidaTypewriter f (strcmp) 1902 3212 w 9 /LucidaSansUnicode00 f (:) 2292 3212 w 9 /LucidaTypewriter f (src) 1368 3366 w (-s) 1628 3366 w (strcmp) 1823 3366 w (rc) 2278 3366 w 9 /LucidaSans-Demi f (SOURCE) 720 3520 w 9 /LucidaTypewriter f (/rc/bin/src) 1044 3630 w 9 /LucidaSans-Demi f (SEE) 720 3784 w (ALSO) 908 3784 w 9 /LucidaSans-Italic f (db) 1044 3894 w 9 /LucidaSansUnicode00 f (\(1\),) 1161 3894 w 9 /LucidaSans-Italic f (plumb) 1336 3894 w 9 /LucidaSansUnicode00 f (\(1\),) 1619 3894 w 9 /LucidaSans-Italic f (sam) 1794 3894 w 9 /LucidaSansUnicode00 f (\(1\).) 1984 3894 w (1) 3031 7700 w cleartomark showpage saveobj restore %%EndPage: 10 10 %%Page: 11 11 /saveobj save def mark 11 pagesetup 10 /LucidaSans-Typewriter83 f (/sys/man/2/pipe) 720 470 w (.TH PIPE 2) 720 830 w (.SH NAME) 720 940 w (pipe ) 720 1050 w 10 /LucidaSansUnicode20 f (\023) 970 1050 w 10 /LucidaSans-Typewriter83 f (create an interprocess channel) 1070 1050 w (.SH SYNOPSIS) 720 1160 w (.B #include ) 720 1270 w (.br) 720 1380 w (.B #include ) 720 1490 w (.PP) 720 1600 w (.B) 720 1710 w (int pipe\(int fd[2]\)) 720 1820 w (.SH DESCRIPTION) 720 1930 w (.I Pipe) 720 2040 w (creates a buffered channel for) 720 2150 w (interprocess I/O communication.) 720 2260 w (Two file descriptors are returned in) 720 2370 w (.IR fd .) 720 2480 w (Data written to) 720 2590 w (.B fd[1]) 720 2700 w (is available for reading from) 720 2810 w (.B fd[0]) 720 2920 w (and data written to) 720 3030 w (.B fd[0]) 720 3140 w (is available for reading from) 720 3250 w (.BR fd[1] .) 720 3360 w (.PP) 720 3470 w (After the pipe has been established,) 720 3580 w (cooperating processes) 720 3690 w (created by subsequent) 720 3800 w (.IR fork \(2\)) 720 3910 w (calls may pass data through the) 720 4020 w (pipe with) 720 4130 w (.I read) 720 4240 w (and) 720 4350 w (.I write) 720 4460 w (calls.) 720 4570 w (The bytes placed on a pipe) 720 4680 w (by one) 720 4790 w (.I write) 720 4900 w (are contiguous even if many processes) 720 5010 w (are writing.) 720 5120 w (Write boundaries are preserved:) 720 5230 w (each read terminates when the read) 720 5340 w (buffer is full or after reading the) 720 5450 w (last byte of a write, whichever comes) 720 5560 w (first.) 720 5670 w (.PP) 720 5780 w (The number of bytes available to a) 720 5890 w (.IR read \(2\)) 720 6000 w (is reported) 720 6110 w (in the) 720 6220 w (.B Length) 720 6330 w (field returned by) 720 6440 w (.I fstat) 720 6550 w (or) 720 6660 w (.I dirfstat) 720 6770 w (on a pipe \(see) 720 6880 w (.IR stat \(2\)\).) 720 6990 w (.PP) 720 7100 w (When all the data has been read from a) 720 7210 w (pipe and the writer has closed the pipe) 3150 830 w (or exited,) 3150 940 w (.IR read \(2\)) 3150 1050 w (will return 0 bytes.) 3150 1160 w (Writes to a pipe) 4250 1160 w (with no reader will generate a note) 3150 1270 w (.BR "sys: write on closed pipe" .) 3150 1380 w (.SH SOURCE) 3150 1490 w (.B /sys/src/libc/9syscall) 3150 1600 w (.SH SEE ALSO) 3150 1710 w (.IR intro \(2\),) 3150 1820 w (.IR read \(2\),) 3150 1930 w (.IR pipe \(3\)) 3150 2040 w (.SH DIAGNOSTICS) 3150 2150 w (Sets) 3150 2260 w (.IR errstr .) 3150 2370 w (.SH BUGS) 3150 2480 w (If a read or a write of a pipe is) 3150 2590 w (interrupted, some unknown number) 3150 2700 w (of bytes may have been transferred.) 3150 2810 w (.br) 3150 2920 w (When a read from a pipe returns 0 bytes,) 3150 3030 w (it usually means end of file but is) 3150 3140 w (indistinguishable from reading the result) 3150 3250 w (of an explicit write of zero bytes.) 3150 3360 w cleartomark showpage saveobj restore %%EndPage: 11 11 %%Page: 12 12 /saveobj save def mark 12 pagesetup 9 /LucidaSansUnicode00 f (PIPE) 720 440 w (\() 902 440 w (2) 939 440 w (\)) 1003 440 w (PIPE) 5087 440 w (\() 5269 440 w (2) 5306 440 w (\)) 5370 440 w 9 /LucidaSans-Demi f (NAME) 720 1034 w 9 /LucidaSansUnicode00 f (pipe) 1044 1144 w 9 /LucidaSansUnicode20 f (\023) 1263 1144 w 9 /LucidaSansUnicode00 f (create) 1337 1144 w (an) 1632 1144 w (interprocess) 1767 1144 w (channel) 2335 1144 w 9 /LucidaSans-Demi f (SYNOPSIS) 720 1298 w 9 /LucidaTypewriter f (#include) 1044 1408 w () 1629 1408 w (#include) 1044 1518 w () 1629 1518 w (int) 1044 1672 w (pipe\(int) 1304 1672 w (fd[2]\)) 1889 1672 w 9 /LucidaSans-Demi f (DESCRIPTION) 720 1826 w 9 /LucidaSans-Italic f (Pipe) 1044 1936 w 9 /LucidaSansUnicode00 f (creates) 1276 1936 w (a) 1639 1936 w (buffered) 1740 1936 w (channel) 2164 1936 w (for) 2555 1936 w (interprocess) 2731 1936 w (I/O) 3322 1936 w (communication.) 3518 1936 w (Two) 4301 1936 w (file) 4534 1936 w (descriptors) 4721 1936 w (are) 5263 1936 w (returned) 1044 2046 w (in) 1462 2046 w 9 /LucidaSans-Italic f (fd) 1586 2046 w 9 /LucidaSansUnicode00 f (.) 1682 2046 w (Data) 1753 2046 w (written) 1996 2046 w (to) 2342 2046 w 9 /LucidaTypewriter f (fd[1]) 2472 2046 w 9 /LucidaSansUnicode00 f (is) 2839 2046 w (available) 2953 2046 w (for) 3377 2046 w (reading) 3543 2046 w (from) 3916 2046 w 9 /LucidaTypewriter f (fd[0]) 4166 2046 w 9 /LucidaSansUnicode00 f (and) 4532 2046 w (data) 4736 2046 w (written) 4967 2046 w (to) 5312 2046 w 9 /LucidaTypewriter f (fd[0]) 1044 2156 w 9 /LucidaSansUnicode00 f (is) 1398 2156 w (available) 1499 2156 w (for) 1910 2156 w (reading) 2064 2156 w (from) 2425 2156 w 9 /LucidaTypewriter f (fd[1]) 2663 2156 w 9 /LucidaSansUnicode00 f (.) 2988 2156 w (After) 1044 2310 w (the) 1303 2310 w (pipe) 1486 2310 w (has) 1720 2310 w (been) 1916 2310 w (established,) 2173 2310 w (cooperating) 2744 2310 w (processes) 3310 2310 w (created) 3788 2310 w (by) 4156 2310 w (subsequent) 4305 2310 w 9 /LucidaSans-Italic f (fork) 4857 2310 w 9 /LucidaSansUnicode00 f (\(2\)) 5044 2310 w (calls) 5206 2310 w (may) 1044 2420 w (pass) 1255 2420 w (data) 1484 2420 w (through) 1704 2420 w (the) 2083 2420 w (pipe) 2252 2420 w (with) 2472 2420 w 9 /LucidaSans-Italic f (read) 2686 2420 w 9 /LucidaSansUnicode00 f (and) 2917 2420 w 9 /LucidaSans-Italic f (write) 3110 2420 w 9 /LucidaSansUnicode00 f (calls.) 3361 2420 w (The) 3643 2420 w (bytes) 3836 2420 w (placed) 4099 2420 w (on) 4415 2420 w (a) 4556 2420 w (pipe) 4636 2420 w (by) 4856 2420 w (one) 4989 2420 w 9 /LucidaSans-Italic f (write) 5179 2420 w 9 /LucidaSansUnicode00 f (are) 1044 2530 w (contiguous) 1213 2530 w (even) 1730 2530 w (if) 1965 2530 w (many) 2056 2530 w (processes) 2325 2530 w (are) 2790 2530 w (writing.) 2959 2530 w (Write) 3352 2530 w (boundaries) 3607 2530 w (are) 4129 2530 w (preserved:) 4298 2530 w (each) 4790 2530 w (read) 5024 2530 w (ter\255) 5250 2530 w (minates) 1044 2640 w (when) 1418 2640 w (the) 1678 2640 w (read) 1846 2640 w (buffer) 2069 2640 w (is) 2364 2640 w (full) 2465 2640 w (or) 2635 2640 w (after) 2756 2640 w (reading) 2988 2640 w (the) 3349 2640 w (last) 3517 2640 w (byte) 3701 2640 w (of) 3917 2640 w (a) 4034 2640 w (write,) 4113 2640 w (whichever) 4386 2640 w (comes) 4852 2640 w (first.) 5162 2640 w (The) 1044 2794 w (number) 1246 2794 w (of) 1625 2794 w (bytes) 1752 2794 w (available) 2024 2794 w (to) 2445 2794 w (a) 2572 2794 w 9 /LucidaSans-Italic f (read) 2661 2794 w 9 /LucidaSansUnicode00 f (\(2\)) 2869 2794 w (is) 3025 2794 w (reported) 3136 2794 w (in) 3551 2794 w (the) 3672 2794 w 9 /LucidaTypewriter f (Length) 3850 2794 w 9 /LucidaSansUnicode00 f (field) 4279 2794 w (returned) 4510 2794 w (by) 4925 2794 w 9 /LucidaSans-Italic f (fstat) 5068 2794 w 9 /LucidaSansUnicode00 f (or) 5308 2794 w 9 /LucidaSans-Italic f (dirfstat) 1044 2904 w 9 /LucidaSansUnicode00 f (on) 1398 2904 w (a) 1538 2904 w (pipe) 1617 2904 w (\(see) 1836 2904 w 9 /LucidaSans-Italic f (stat) 2041 2904 w 9 /LucidaSansUnicode00 f (\(2\)\).) 2215 2904 w (When) 1044 3058 w (all) 1317 3058 w (the) 1453 3058 w (data) 1626 3058 w (has) 1850 3058 w (been) 2036 3058 w (read) 2283 3058 w (from) 2511 3058 w (a) 2754 3058 w (pipe) 2838 3058 w (and) 3062 3058 w (the) 3259 3058 w (writer) 3432 3058 w (has) 3718 3058 w (closed) 3904 3058 w (the) 4218 3058 w (pipe) 4391 3058 w (or) 4615 3058 w (exited,) 4741 3058 w 9 /LucidaSans-Italic f (read) 5075 3058 w 9 /LucidaSansUnicode00 f (\(2\)) 5283 3058 w (will) 1044 3168 w (return) 1242 3168 w (0) 1562 3168 w (bytes.) 1670 3168 w (Writes) 2012 3168 w (to) 2332 3168 w (a) 2471 3168 w (pipe) 2572 3168 w (with) 2813 3168 w (no) 3048 3168 w (reader) 3209 3168 w (will) 3540 3168 w (generate) 3737 3168 w (a) 4169 3168 w (note) 4269 3168 w 9 /LucidaTypewriter f (sys:) 4513 3168 w (write) 4859 3168 w (on) 5270 3168 w (closed) 1044 3278 w (pipe) 1499 3278 w 9 /LucidaSansUnicode00 f (.) 1759 3278 w 9 /LucidaSans-Demi f (SOURCE) 720 3432 w 9 /LucidaTypewriter f (/sys/src/libc/9syscall) 1044 3542 w 9 /LucidaSans-Demi f (SEE) 720 3696 w (ALSO) 923 3696 w 9 /LucidaSans-Italic f (intro) 1044 3806 w 9 /LucidaSansUnicode00 f (\(2\),) 1261 3806 w 9 /LucidaSans-Italic f (read) 1436 3806 w 9 /LucidaSansUnicode00 f (\(2\),) 1644 3806 w 9 /LucidaSans-Italic f (pipe) 1819 3806 w 9 /LucidaSansUnicode00 f (\(3\)) 2010 3806 w 9 /LucidaSans-Demi f (DIAGNOSTICS) 720 3960 w 9 /LucidaSansUnicode00 f (Sets) 1044 4070 w 9 /LucidaSans-Italic f (errstr) 1251 4070 w 9 /LucidaSansUnicode00 f (.) 1513 4070 w 9 /LucidaSans-Demi f (BUGS) 720 4224 w 9 /LucidaSansUnicode00 f (If) 1044 4334 w (a) 1136 4334 w (read) 1219 4334 w (or) 1446 4334 w (a) 1571 4334 w (write) 1654 4334 w (of) 1902 4334 w (a) 2023 4334 w (pipe) 2106 4334 w (is) 2329 4334 w (interrupted,) 2434 4334 w (some) 2988 4334 w (unknown) 3256 4334 w (number) 3689 4334 w (of) 4062 4334 w (bytes) 4183 4334 w (may) 4449 4334 w (have) 4664 4334 w (been) 4901 4334 w (trans\255) 5148 4334 w (ferred.) 1044 4444 w (When) 1044 4554 w (a) 1315 4554 w (read) 1397 4554 w (from) 1623 4554 w (a) 1864 4554 w (pipe) 1946 4554 w (returns) 2168 4554 w (0) 2515 4554 w (bytes,) 2604 4554 w (it) 2898 4554 w (usually) 2989 4554 w (means) 3328 4554 w (end) 3646 4554 w (of) 3841 4554 w (file) 3961 4554 w (but) 4128 4554 w (is) 4306 4554 w (indistinguishable) 4410 4554 w (from) 5191 4554 w (reading) 1044 4664 w (the) 1405 4664 w (result) 1573 4664 w (of) 1850 4664 w (an) 1967 4664 w (explicit) 2102 4664 w (write) 2450 4664 w (of) 2694 4664 w (zero) 2811 4664 w (bytes.) 3033 4664 w (1) 3031 7700 w cleartomark showpage saveobj restore %%EndPage: 12 12 %%Trailer done %%DocumentFonts: LucidaSansUnicode20 LucidaSansUnicode00 LucidaSans-Demi LucidaSans-Italic LucidaTypewriter LucidaSans-Typewriter83 %%Pages: 12