File
doc/man.macros
— part of check-in
[79367df0f0]
at
2011-03-02 16:06:41
on branch core-8-5-branch
— Now that we're no longer using SCM based on RCS, the RCS Keyword lines cause
more harm than good. Purged them.
(user:
dgp
size: 5810)
[more...]
File
library/msgcat/doc/man.macros
— part of check-in
[d505b7f4cd]
at
2011-10-27 20:15:33
on branch dgp-pkg-migration
— Work In Progress migrating msgcat package to tcl/pkgs/ distribution.
Includes inventing configure/make tools/patterns for "pure Tcl" packages.
(user:
dgp
size: 5810)
File
pkgs/msgcat/doc/man.macros
— part of check-in
[d505b7f4cd]
at
2011-10-27 20:15:33
on branch dgp-pkg-migration
— Work In Progress migrating msgcat package to tcl/pkgs/ distribution.
Includes inventing configure/make tools/patterns for "pure Tcl" packages.
(user:
dgp
size: 5810)
0000: 2e 5c 22 20 54 68 65 20 2d 2a 2d 20 6e 72 6f 66 .\" The -*- nrof
0010: 66 20 2d 2a 2d 20 64 65 66 69 6e 69 74 69 6f 6e f -*- definition
0020: 73 20 62 65 6c 6f 77 20 61 72 65 20 66 6f 72 20 s below are for
0030: 73 75 70 70 6c 65 6d 65 6e 74 61 6c 20 6d 61 63 supplemental mac
0040: 72 6f 73 20 75 73 65 64 0a 2e 5c 22 20 69 6e 20 ros used..\" in
0050: 54 63 6c 2f 54 6b 20 6d 61 6e 75 61 6c 20 65 6e Tcl/Tk manual en
0060: 74 72 69 65 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e tries...\"..\" .
0070: 41 50 20 74 79 70 65 20 6e 61 6d 65 20 69 6e 2f AP type name in/
0080: 6f 75 74 20 3f 69 6e 64 65 6e 74 3f 0a 2e 5c 22 out ?indent?..\"
0090: 09 53 74 61 72 74 20 70 61 72 61 67 72 61 70 68 .Start paragraph
00a0: 20 64 65 73 63 72 69 62 69 6e 67 20 61 6e 20 61 describing an a
00b0: 72 67 75 6d 65 6e 74 20 74 6f 20 61 20 6c 69 62 rgument to a lib
00c0: 72 61 72 79 20 70 72 6f 63 65 64 75 72 65 2e 0a rary procedure..
00d0: 2e 5c 22 09 74 79 70 65 20 69 73 20 74 79 70 65 .\".type is type
00e0: 20 6f 66 20 61 72 67 75 6d 65 6e 74 20 28 69 6e of argument (in
00f0: 74 2c 20 65 74 63 2e 29 2c 20 69 6e 2f 6f 75 74 t, etc.), in/out
0100: 20 69 73 20 65 69 74 68 65 72 20 22 69 6e 22 2c is either "in",
0110: 20 22 6f 75 74 22 2c 0a 2e 5c 22 09 6f 72 20 22 "out",..\".or "
0120: 69 6e 2f 6f 75 74 22 20 74 6f 20 64 65 73 63 72 in/out" to descr
0130: 69 62 65 20 77 68 65 74 68 65 72 20 70 72 6f 63 ibe whether proc
0140: 65 64 75 72 65 20 72 65 61 64 73 20 6f 72 20 6d edure reads or m
0150: 6f 64 69 66 69 65 73 20 61 72 67 2c 0a 2e 5c 22 odifies arg,..\"
0160: 09 61 6e 64 20 69 6e 64 65 6e 74 20 69 73 20 65 .and indent is e
0170: 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 73 65 63 quivalent to sec
0180: 6f 6e 64 20 61 72 67 20 6f 66 20 2e 49 50 20 28 ond arg of .IP (
0190: 73 68 6f 75 6c 64 6e 27 74 20 65 76 65 72 20 62 shouldn't ever b
01a0: 65 0a 2e 5c 22 09 6e 65 65 64 65 64 3b 20 20 75 e..\".needed; u
01b0: 73 65 20 2e 41 53 20 62 65 6c 6f 77 20 69 6e 73 se .AS below ins
01c0: 74 65 61 64 29 0a 2e 5c 22 0a 2e 5c 22 20 2e 41 tead)..\"..\" .A
01d0: 53 20 3f 74 79 70 65 3f 20 3f 6e 61 6d 65 3f 0a S ?type? ?name?.
01e0: 2e 5c 22 09 47 69 76 65 20 6d 61 78 69 6d 75 6d .\".Give maximum
01f0: 20 73 69 7a 65 73 20 6f 66 20 61 72 67 75 6d 65 sizes of argume
0200: 6e 74 73 20 66 6f 72 20 73 65 74 74 69 6e 67 20 nts for setting
0210: 74 61 62 20 73 74 6f 70 73 2e 20 20 54 79 70 65 tab stops. Type
0220: 20 61 6e 64 0a 2e 5c 22 09 6e 61 6d 65 20 61 72 and..\".name ar
0230: 65 20 65 78 61 6d 70 6c 65 73 20 6f 66 20 6c 61 e examples of la
0240: 72 67 65 73 74 20 70 6f 73 73 69 62 6c 65 20 61 rgest possible a
0250: 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 77 69 rguments that wi
0260: 6c 6c 20 62 65 20 70 61 73 73 65 64 0a 2e 5c 22 ll be passed..\"
0270: 09 74 6f 20 2e 41 50 20 6c 61 74 65 72 2e 20 20 .to .AP later.
0280: 49 66 20 61 72 67 73 20 61 72 65 20 6f 6d 69 74 If args are omit
0290: 74 65 64 2c 20 64 65 66 61 75 6c 74 20 74 61 62 ted, default tab
02a0: 20 73 74 6f 70 73 20 61 72 65 20 75 73 65 64 2e stops are used.
02b0: 0a 2e 5c 22 0a 2e 5c 22 20 2e 42 53 0a 2e 5c 22 ..\"..\" .BS..\"
02c0: 09 53 74 61 72 74 20 62 6f 78 20 65 6e 63 6c 6f .Start box enclo
02d0: 73 75 72 65 2e 20 20 46 72 6f 6d 20 68 65 72 65 sure. From here
02e0: 20 75 6e 74 69 6c 20 6e 65 78 74 20 2e 42 45 2c until next .BE,
02f0: 20 65 76 65 72 79 74 68 69 6e 67 20 77 69 6c 6c everything will
0300: 20 62 65 0a 2e 5c 22 09 65 6e 63 6c 6f 73 65 64 be..\".enclosed
0310: 20 69 6e 20 6f 6e 65 20 6c 61 72 67 65 20 62 6f in one large bo
0320: 78 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 42 45 0a 2e x...\"..\" .BE..
0330: 5c 22 09 45 6e 64 20 6f 66 20 62 6f 78 20 65 6e \".End of box en
0340: 63 6c 6f 73 75 72 65 2e 0a 2e 5c 22 0a 2e 5c 22 closure...\"..\"
0350: 20 2e 43 53 0a 2e 5c 22 09 42 65 67 69 6e 20 63 .CS..\".Begin c
0360: 6f 64 65 20 65 78 63 65 72 70 74 2e 0a 2e 5c 22 ode excerpt...\"
0370: 0a 2e 5c 22 20 2e 43 45 0a 2e 5c 22 09 45 6e 64 ..\" .CE..\".End
0380: 20 63 6f 64 65 20 65 78 63 65 72 70 74 2e 0a 2e code excerpt...
0390: 5c 22 0a 2e 5c 22 20 2e 56 53 20 3f 76 65 72 73 \"..\" .VS ?vers
03a0: 69 6f 6e 3f 20 3f 62 72 3f 0a 2e 5c 22 09 42 65 ion? ?br?..\".Be
03b0: 67 69 6e 20 76 65 72 74 69 63 61 6c 20 73 69 64 gin vertical sid
03c0: 65 62 61 72 2c 20 66 6f 72 20 75 73 65 20 69 6e ebar, for use in
03d0: 20 6d 61 72 6b 69 6e 67 20 6e 65 77 6c 79 2d 63 marking newly-c
03e0: 68 61 6e 67 65 64 20 70 61 72 74 73 0a 2e 5c 22 hanged parts..\"
03f0: 09 6f 66 20 6d 61 6e 20 70 61 67 65 73 2e 20 20 .of man pages.
0400: 54 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 The first argume
0410: 6e 74 20 69 73 20 69 67 6e 6f 72 65 64 20 61 6e nt is ignored an
0420: 64 20 75 73 65 64 20 66 6f 72 20 72 65 63 6f 72 d used for recor
0430: 64 69 6e 67 0a 2e 5c 22 09 74 68 65 20 76 65 72 ding..\".the ver
0440: 73 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 2e 56 sion when the .V
0450: 53 20 77 61 73 20 61 64 64 65 64 2c 20 73 6f 20 S was added, so
0460: 74 68 61 74 20 74 68 65 20 73 69 64 65 62 61 72 that the sidebar
0470: 73 20 63 61 6e 20 62 65 0a 2e 5c 22 09 66 6f 75 s can be..\".fou
0480: 6e 64 20 61 6e 64 20 72 65 6d 6f 76 65 64 20 77 nd and removed w
0490: 68 65 6e 20 74 68 65 79 20 72 65 61 63 68 20 61 hen they reach a
04a0: 20 63 65 72 74 61 69 6e 20 61 67 65 2e 20 20 49 certain age. I
04b0: 66 20 61 6e 6f 74 68 65 72 20 61 72 67 75 6d 65 f another argume
04c0: 6e 74 0a 2e 5c 22 09 69 73 20 70 72 65 73 65 6e nt..\".is presen
04d0: 74 2c 20 74 68 65 6e 20 61 20 6c 69 6e 65 20 62 t, then a line b
04e0: 72 65 61 6b 20 69 73 20 66 6f 72 63 65 64 20 62 reak is forced b
04f0: 65 66 6f 72 65 20 73 74 61 72 74 69 6e 67 20 74 efore starting t
0500: 68 65 20 73 69 64 65 62 61 72 2e 0a 2e 5c 22 0a he sidebar...\".
0510: 2e 5c 22 20 2e 56 45 0a 2e 5c 22 09 45 6e 64 20 .\" .VE..\".End
0520: 6f 66 20 76 65 72 74 69 63 61 6c 20 73 69 64 65 of vertical side
0530: 62 61 72 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 44 53 bar...\"..\" .DS
0540: 0a 2e 5c 22 09 42 65 67 69 6e 20 61 6e 20 69 6e ..\".Begin an in
0550: 64 65 6e 74 65 64 20 75 6e 66 69 6c 6c 65 64 20 dented unfilled
0560: 64 69 73 70 6c 61 79 2e 0a 2e 5c 22 0a 2e 5c 22 display...\"..\"
0570: 20 2e 44 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 .DE..\".End of
0580: 69 6e 64 65 6e 74 65 64 20 75 6e 66 69 6c 6c 65 indented unfille
0590: 64 20 64 69 73 70 6c 61 79 2e 0a 2e 5c 22 0a 2e d display...\"..
05a0: 5c 22 20 2e 53 4f 20 3f 6d 61 6e 70 61 67 65 3f \" .SO ?manpage?
05b0: 0a 2e 5c 22 09 53 74 61 72 74 20 6f 66 20 6c 69 ..\".Start of li
05c0: 73 74 20 6f 66 20 73 74 61 6e 64 61 72 64 20 6f st of standard o
05d0: 70 74 69 6f 6e 73 20 66 6f 72 20 61 20 54 6b 20 ptions for a Tk
05e0: 77 69 64 67 65 74 2e 20 54 68 65 20 6d 61 6e 70 widget. The manp
05f0: 61 67 65 0a 2e 5c 22 09 61 72 67 75 6d 65 6e 74 age..\".argument
0600: 20 64 65 66 69 6e 65 73 20 77 68 65 72 65 20 74 defines where t
0610: 6f 20 6c 6f 6f 6b 20 75 70 20 74 68 65 20 73 74 o look up the st
0620: 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 3b 20 andard options;
0630: 69 66 0a 2e 5c 22 09 6f 6d 69 74 74 65 64 2c 20 if..\".omitted,
0640: 64 65 66 61 75 6c 74 73 20 74 6f 20 22 6f 70 74 defaults to "opt
0650: 69 6f 6e 73 22 2e 20 54 68 65 20 6f 70 74 69 6f ions". The optio
0660: 6e 73 20 66 6f 6c 6c 6f 77 20 6f 6e 20 73 75 63 ns follow on suc
0670: 63 65 73 73 69 76 65 0a 2e 5c 22 09 6c 69 6e 65 cessive..\".line
0680: 73 2c 20 69 6e 20 74 68 72 65 65 20 63 6f 6c 75 s, in three colu
0690: 6d 6e 73 20 73 65 70 61 72 61 74 65 64 20 62 79 mns separated by
06a0: 20 74 61 62 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e tabs...\"..\" .
06b0: 53 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 6c 69 SE..\".End of li
06c0: 73 74 20 6f 66 20 73 74 61 6e 64 61 72 64 20 6f st of standard o
06d0: 70 74 69 6f 6e 73 20 66 6f 72 20 61 20 54 6b 20 ptions for a Tk
06e0: 77 69 64 67 65 74 2e 0a 2e 5c 22 0a 2e 5c 22 20 widget...\"..\"
06f0: 2e 4f 50 20 63 6d 64 4e 61 6d 65 20 64 62 4e 61 .OP cmdName dbNa
0700: 6d 65 20 64 62 43 6c 61 73 73 0a 2e 5c 22 09 53 me dbClass..\".S
0710: 74 61 72 74 20 6f 66 20 64 65 73 63 72 69 70 74 tart of descript
0720: 69 6f 6e 20 6f 66 20 61 20 73 70 65 63 69 66 69 ion of a specifi
0730: 63 20 6f 70 74 69 6f 6e 2e 20 20 63 6d 64 4e 61 c option. cmdNa
0740: 6d 65 20 67 69 76 65 73 20 74 68 65 0a 2e 5c 22 me gives the..\"
0750: 09 6f 70 74 69 6f 6e 27 73 20 6e 61 6d 65 20 61 .option's name a
0760: 73 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 s specified in t
0770: 68 65 20 63 6c 61 73 73 20 63 6f 6d 6d 61 6e 64 he class command
0780: 2c 20 64 62 4e 61 6d 65 20 67 69 76 65 73 0a 2e , dbName gives..
0790: 5c 22 09 74 68 65 20 6f 70 74 69 6f 6e 27 73 20 \".the option's
07a0: 6e 61 6d 65 20 69 6e 20 74 68 65 20 6f 70 74 69 name in the opti
07b0: 6f 6e 20 64 61 74 61 62 61 73 65 2c 20 61 6e 64 on database, and
07c0: 20 64 62 43 6c 61 73 73 20 67 69 76 65 73 0a 2e dbClass gives..
07d0: 5c 22 09 74 68 65 20 6f 70 74 69 6f 6e 27 73 20 \".the option's
07e0: 63 6c 61 73 73 20 69 6e 20 74 68 65 20 6f 70 74 class in the opt
07f0: 69 6f 6e 20 64 61 74 61 62 61 73 65 2e 0a 2e 5c ion database...\
0800: 22 0a 2e 5c 22 20 2e 55 4c 20 61 72 67 31 20 61 "..\" .UL arg1 a
0810: 72 67 32 0a 2e 5c 22 09 50 72 69 6e 74 20 61 72 rg2..\".Print ar
0820: 67 31 20 75 6e 64 65 72 6c 69 6e 65 64 2c 20 74 g1 underlined, t
0830: 68 65 6e 20 70 72 69 6e 74 20 61 72 67 32 20 6e hen print arg2 n
0840: 6f 72 6d 61 6c 6c 79 2e 0a 2e 5c 22 0a 2e 5c 22 ormally...\"..\"
0850: 20 2e 51 57 20 61 72 67 31 20 3f 61 72 67 32 3f .QW arg1 ?arg2?
0860: 0a 2e 5c 22 09 50 72 69 6e 74 20 61 72 67 31 20 ..\".Print arg1
0870: 69 6e 20 71 75 6f 74 65 73 2c 20 74 68 65 6e 20 in quotes, then
0880: 61 72 67 32 20 6e 6f 72 6d 61 6c 6c 79 20 28 66 arg2 normally (f
0890: 6f 72 20 74 72 61 69 6c 69 6e 67 20 70 75 6e 63 or trailing punc
08a0: 74 75 61 74 69 6f 6e 29 2e 0a 2e 5c 22 0a 2e 5c tuation)...\"..\
08b0: 22 20 2e 50 51 20 61 72 67 31 20 3f 61 72 67 32 " .PQ arg1 ?arg2
08c0: 3f 0a 2e 5c 22 09 50 72 69 6e 74 20 61 6e 20 6f ?..\".Print an o
08d0: 70 65 6e 20 70 61 72 65 6e 74 68 65 73 69 73 2c pen parenthesis,
08e0: 20 61 72 67 31 20 69 6e 20 71 75 6f 74 65 73 2c arg1 in quotes,
08f0: 20 74 68 65 6e 20 61 72 67 32 20 6e 6f 72 6d 61 then arg2 norma
0900: 6c 6c 79 0a 2e 5c 22 09 28 66 6f 72 20 74 72 61 lly..\".(for tra
0910: 69 6c 69 6e 67 20 70 75 6e 63 74 75 61 74 69 6f iling punctuatio
0920: 6e 29 20 61 6e 64 20 74 68 65 6e 20 61 20 63 6c n) and then a cl
0930: 6f 73 69 6e 67 20 70 61 72 65 6e 74 68 65 73 69 osing parenthesi
0940: 73 2e 0a 2e 5c 22 0a 2e 5c 22 09 23 20 53 65 74 s...\"..\".# Set
0950: 20 75 70 20 74 72 61 70 73 20 61 6e 64 20 6f 74 up traps and ot
0960: 68 65 72 20 6d 69 73 63 65 6c 6c 61 6e 65 6f 75 her miscellaneou
0970: 73 20 73 74 75 66 66 20 66 6f 72 20 54 63 6c 2f s stuff for Tcl/
0980: 54 6b 20 6d 61 6e 20 70 61 67 65 73 2e 0a 2e 69 Tk man pages...i
0990: 66 20 74 20 2e 77 68 20 2d 31 2e 33 69 20 5e 42 f t .wh -1.3i ^B
09a0: 0a 2e 6e 72 20 5e 6c 20 5c 6e 28 2e 6c 0a 2e 61 ..nr ^l \n(.l..a
09b0: 64 20 62 0a 2e 5c 22 09 23 20 53 74 61 72 74 20 d b..\".# Start
09c0: 61 6e 20 61 72 67 75 6d 65 6e 74 20 64 65 73 63 an argument desc
09d0: 72 69 70 74 69 6f 6e 0a 2e 64 65 20 41 50 0a 2e ription..de AP..
09e0: 69 65 20 21 22 5c 5c 24 34 22 22 20 2e 54 50 20 ie !"\\$4"" .TP
09f0: 5c 5c 24 34 0a 2e 65 6c 20 5c 7b 5c 0a 2e 20 20 \\$4..el \{\..
0a00: 20 69 65 20 21 22 5c 5c 24 32 22 22 20 2e 54 50 ie !"\\$2"" .TP
0a10: 20 5c 5c 6e 28 29 43 75 0a 2e 20 20 20 65 6c 20 \\n()Cu.. el
0a20: 20 20 20 20 20 20 20 20 20 2e 54 50 20 31 35 0a .TP 15.
0a30: 2e 5c 7d 0a 2e 74 61 20 5c 5c 6e 28 29 41 75 20 .\}..ta \\n()Au
0a40: 5c 5c 6e 28 29 42 75 0a 2e 69 65 20 21 22 5c 5c \\n()Bu..ie !"\\
0a50: 24 33 22 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 31 20 $3"" \{\.\&\\$1
0a60: 5c 5c 66 49 5c 5c 24 32 5c 5c 66 50 20 28 5c 5c \\fI\\$2\\fP (\\
0a70: 24 33 29 0a 2e 5c 22 2e 62 0a 2e 5c 7d 0a 2e 65 $3)..\".b..\}..e
0a80: 6c 20 5c 7b 5c 0a 2e 62 72 0a 2e 69 65 20 21 22 l \{\..br..ie !"
0a90: 5c 5c 24 32 22 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 \\$2"" \{\.\&\\$
0aa0: 31 09 5c 5c 66 49 5c 5c 24 32 5c 5c 66 50 0a 2e 1.\\fI\\$2\\fP..
0ab0: 5c 7d 0a 2e 65 6c 20 5c 7b 5c 0a 5c 26 5c 5c 66 \}..el \{\.\&\\f
0ac0: 49 5c 5c 24 31 5c 5c 66 50 0a 2e 5c 7d 0a 2e 5c I\\$1\\fP..\}..\
0ad0: 7d 0a 2e 2e 0a 2e 5c 22 09 23 20 64 65 66 69 6e }.....\".# defin
0ae0: 65 20 74 61 62 62 69 6e 67 20 76 61 6c 75 65 73 e tabbing values
0af0: 20 66 6f 72 20 2e 41 50 0a 2e 64 65 20 41 53 0a for .AP..de AS.
0b00: 2e 6e 72 20 29 41 20 31 30 6e 0a 2e 69 66 20 21 .nr )A 10n..if !
0b10: 22 5c 5c 24 31 22 22 20 2e 6e 72 20 29 41 20 5c "\\$1"" .nr )A \
0b20: 5c 77 27 5c 5c 24 31 27 75 2b 33 6e 0a 2e 6e 72 \w'\\$1'u+3n..nr
0b30: 20 29 42 20 5c 5c 6e 28 29 41 75 2b 31 35 6e 0a )B \\n()Au+15n.
0b40: 2e 5c 22 0a 2e 69 66 20 21 22 5c 5c 24 32 22 22 .\"..if !"\\$2""
0b50: 20 2e 6e 72 20 29 42 20 5c 5c 77 27 5c 5c 24 32 .nr )B \\w'\\$2
0b60: 27 75 2b 5c 5c 6e 28 29 41 75 2b 33 6e 0a 2e 6e 'u+\\n()Au+3n..n
0b70: 72 20 29 43 20 5c 5c 6e 28 29 42 75 2b 5c 5c 77 r )C \\n()Bu+\\w
0b80: 27 28 69 6e 2f 6f 75 74 29 27 75 2b 32 6e 0a 2e '(in/out)'u+2n..
0b90: 2e 0a 2e 41 53 20 54 63 6c 5f 49 6e 74 65 72 70 ...AS Tcl_Interp
0ba0: 20 54 63 6c 5f 43 72 65 61 74 65 49 6e 74 65 72 Tcl_CreateInter
0bb0: 70 20 69 6e 2f 6f 75 74 0a 2e 5c 22 09 23 20 42 p in/out..\".# B
0bc0: 53 20 2d 20 73 74 61 72 74 20 62 6f 78 65 64 20 S - start boxed
0bd0: 74 65 78 74 0a 2e 5c 22 09 23 20 5e 79 20 3d 20 text..\".# ^y =
0be0: 73 74 61 72 74 69 6e 67 20 79 20 6c 6f 63 61 74 starting y locat
0bf0: 69 6f 6e 0a 2e 5c 22 09 23 20 5e 62 20 3d 20 31 ion..\".# ^b = 1
0c00: 0a 2e 64 65 20 42 53 0a 2e 62 72 0a 2e 6d 6b 20 ..de BS..br..mk
0c10: 5e 79 0a 2e 6e 72 20 5e 62 20 31 75 0a 2e 69 66 ^y..nr ^b 1u..if
0c20: 20 6e 20 2e 6e 66 0a 2e 69 66 20 6e 20 2e 74 69 n .nf..if n .ti
0c30: 20 30 0a 2e 69 66 20 6e 20 5c 6c 27 5c 5c 6e 28 0..if n \l'\\n(
0c40: 2e 6c 75 5c 28 75 6c 27 0a 2e 69 66 20 6e 20 2e .lu\(ul'..if n .
0c50: 66 69 0a 2e 2e 0a 2e 5c 22 09 23 20 42 45 20 2d fi.....\".# BE -
0c60: 20 65 6e 64 20 62 6f 78 65 64 20 74 65 78 74 20 end boxed text
0c70: 28 64 72 61 77 20 62 6f 78 20 6e 6f 77 29 0a 2e (draw box now)..
0c80: 64 65 20 42 45 0a 2e 6e 66 0a 2e 74 69 20 30 0a de BE..nf..ti 0.
0c90: 2e 6d 6b 20 5e 74 0a 2e 69 65 20 6e 20 5c 6c 27 .mk ^t..ie n \l'
0ca0: 5c 5c 6e 28 5e 6c 75 5c 28 75 6c 27 0a 2e 65 6c \\n(^lu\(ul'..el
0cb0: 20 5c 7b 5c 0a 2e 5c 22 09 44 72 61 77 20 66 6f \{\..\".Draw fo
0cc0: 75 72 2d 73 69 64 65 64 20 62 6f 78 20 6e 6f 72 ur-sided box nor
0cd0: 6d 61 6c 6c 79 2c 20 62 75 74 20 64 6f 6e 27 74 mally, but don't
0ce0: 20 64 72 61 77 20 74 6f 70 20 6f 66 0a 2e 5c 22 draw top of..\"
0cf0: 09 62 6f 78 20 69 66 20 74 68 65 20 62 6f 78 20 .box if the box
0d00: 73 74 61 72 74 65 64 20 6f 6e 20 61 6e 20 65 61 started on an ea
0d10: 72 6c 69 65 72 20 70 61 67 65 2e 0a 2e 69 65 20 rlier page...ie
0d20: 21 5c 5c 6e 28 5e 62 2d 31 20 5c 7b 5c 0a 5c 68 !\\n(^b-1 \{\.\h
0d30: 27 2d 31 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e '-1.5n'\L'|\\n(^
0d40: 79 75 2d 31 76 27 5c 6c 27 5c 5c 6e 28 5e 6c 75 yu-1v'\l'\\n(^lu
0d50: 2b 33 6e 5c 28 75 6c 27 5c 4c 27 5c 5c 6e 28 5e +3n\(ul'\L'\\n(^
0d60: 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27 5c 6c tu+1v-\\n(^yu'\l
0d70: 27 7c 30 75 2d 31 2e 35 6e 5c 28 75 6c 27 0a 2e '|0u-1.5n\(ul'..
0d80: 5c 7d 0a 2e 65 6c 20 5c 7d 5c 0a 5c 68 27 2d 31 \}..el \}\.\h'-1
0d90: 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 79 75 2d .5n'\L'|\\n(^yu-
0da0: 31 76 27 5c 68 27 5c 5c 6e 28 5e 6c 75 2b 33 6e 1v'\h'\\n(^lu+3n
0db0: 27 5c 4c 27 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c '\L'\\n(^tu+1v-\
0dc0: 5c 6e 28 5e 79 75 27 5c 6c 27 7c 30 75 2d 31 2e \n(^yu'\l'|0u-1.
0dd0: 35 6e 5c 28 75 6c 27 0a 2e 5c 7d 0a 2e 5c 7d 0a 5n\(ul'..\}..\}.
0de0: 2e 66 69 0a 2e 62 72 0a 2e 6e 72 20 5e 62 20 30 .fi..br..nr ^b 0
0df0: 0a 2e 2e 0a 2e 5c 22 09 23 20 56 53 20 2d 20 73 .....\".# VS - s
0e00: 74 61 72 74 20 76 65 72 74 69 63 61 6c 20 73 69 tart vertical si
0e10: 64 65 62 61 72 0a 2e 5c 22 09 23 20 5e 59 20 3d debar..\".# ^Y =
0e20: 20 73 74 61 72 74 69 6e 67 20 79 20 6c 6f 63 61 starting y loca
0e30: 74 69 6f 6e 0a 2e 5c 22 09 23 20 5e 76 20 3d 20 tion..\".# ^v =
0e40: 31 20 28 66 6f 72 20 74 72 6f 66 66 3b 20 20 66 1 (for troff; f
0e50: 6f 72 20 6e 72 6f 66 66 20 74 68 69 73 20 64 6f or nroff this do
0e60: 65 73 6e 27 74 20 6d 61 74 74 65 72 29 0a 2e 64 esn't matter)..d
0e70: 65 20 56 53 0a 2e 69 66 20 21 22 5c 5c 24 32 22 e VS..if !"\\$2"
0e80: 22 20 2e 62 72 0a 2e 6d 6b 20 5e 59 0a 2e 69 65 " .br..mk ^Y..ie
0e90: 20 6e 20 27 6d 63 20 5c 73 31 32 5c 28 62 72 5c n 'mc \s12\(br\
0ea0: 73 30 0a 2e 65 6c 20 2e 6e 72 20 5e 76 20 31 75 s0..el .nr ^v 1u
0eb0: 0a 2e 2e 0a 2e 5c 22 09 23 20 56 45 20 2d 20 65 .....\".# VE - e
0ec0: 6e 64 20 6f 66 20 76 65 72 74 69 63 61 6c 20 73 nd of vertical s
0ed0: 69 64 65 62 61 72 0a 2e 64 65 20 56 45 0a 2e 69 idebar..de VE..i
0ee0: 65 20 6e 20 27 6d 63 0a 2e 65 6c 20 5c 7b 5c 0a e n 'mc..el \{\.
0ef0: 2e 65 76 20 32 0a 2e 6e 66 0a 2e 74 69 20 30 0a .ev 2..nf..ti 0.
0f00: 2e 6d 6b 20 5e 74 0a 5c 68 27 7c 5c 5c 6e 28 5e .mk ^t.\h'|\\n(^
0f10: 6c 75 2b 33 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 59 lu+3n'\L'|\\n(^Y
0f20: 75 2d 31 76 5c 28 62 76 27 5c 76 27 5c 5c 6e 28 u-1v\(bv'\v'\\n(
0f30: 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 59 75 27 5c ^tu+1v-\\n(^Yu'\
0f40: 68 27 2d 7c 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 0a h'-|\\n(^lu+3n'.
0f50: 2e 73 70 20 2d 31 0a 2e 66 69 0a 2e 65 76 0a 2e .sp -1..fi..ev..
0f60: 5c 7d 0a 2e 6e 72 20 5e 76 20 30 0a 2e 2e 0a 2e \}..nr ^v 0.....
0f70: 5c 22 09 23 20 53 70 65 63 69 61 6c 20 6d 61 63 \".# Special mac
0f80: 72 6f 20 74 6f 20 68 61 6e 64 6c 65 20 70 61 67 ro to handle pag
0f90: 65 20 62 6f 74 74 6f 6d 3a 20 20 66 69 6e 69 73 e bottom: finis
0fa0: 68 20 6f 66 66 20 63 75 72 72 65 6e 74 0a 2e 5c h off current..\
0fb0: 22 09 23 20 62 6f 78 2f 73 69 64 65 62 61 72 20 ".# box/sidebar
0fc0: 69 66 20 69 6e 20 62 6f 78 2f 73 69 64 65 62 61 if in box/sideba
0fd0: 72 20 6d 6f 64 65 2c 20 74 68 65 6e 20 69 6e 76 r mode, then inv
0fe0: 6f 6b 65 64 20 73 74 61 6e 64 61 72 64 0a 2e 5c oked standard..\
0ff0: 22 09 23 20 70 61 67 65 20 62 6f 74 74 6f 6d 20 ".# page bottom
1000: 6d 61 63 72 6f 2e 0a 2e 64 65 20 5e 42 0a 2e 65 macro...de ^B..e
1010: 76 20 32 0a 27 74 69 20 30 0a 27 6e 66 0a 2e 6d v 2.'ti 0.'nf..m
1020: 6b 20 5e 74 0a 2e 69 66 20 5c 5c 6e 28 5e 62 20 k ^t..if \\n(^b
1030: 5c 7b 5c 0a 2e 5c 22 09 44 72 61 77 20 74 68 72 \{\..\".Draw thr
1040: 65 65 2d 73 69 64 65 64 20 62 6f 78 20 69 66 20 ee-sided box if
1050: 74 68 69 73 20 69 73 20 74 68 65 20 62 6f 78 27 this is the box'
1060: 73 20 66 69 72 73 74 20 70 61 67 65 2c 0a 2e 5c s first page,..\
1070: 22 09 64 72 61 77 20 74 77 6f 20 73 69 64 65 73 ".draw two sides
1080: 20 62 75 74 20 6e 6f 20 74 6f 70 20 6f 74 68 65 but no top othe
1090: 72 77 69 73 65 2e 0a 2e 69 65 20 21 5c 5c 6e 28 rwise...ie !\\n(
10a0: 5e 62 2d 31 20 5c 68 27 2d 31 2e 35 6e 27 5c 4c ^b-1 \h'-1.5n'\L
10b0: 27 7c 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c 6c 27 '|\\n(^yu-1v'\l'
10c0: 5c 5c 6e 28 5e 6c 75 2b 33 6e 5c 28 75 6c 27 5c \\n(^lu+3n\(ul'\
10d0: 4c 27 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e L'\\n(^tu+1v-\\n
10e0: 28 5e 79 75 27 5c 68 27 7c 30 75 27 5c 63 0a 2e (^yu'\h'|0u'\c..
10f0: 65 6c 20 5c 68 27 2d 31 2e 35 6e 27 5c 4c 27 7c el \h'-1.5n'\L'|
1100: 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c 68 27 5c 5c \\n(^yu-1v'\h'\\
1110: 6e 28 5e 6c 75 2b 33 6e 27 5c 4c 27 5c 5c 6e 28 n(^lu+3n'\L'\\n(
1120: 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27 5c ^tu+1v-\\n(^yu'\
1130: 68 27 7c 30 75 27 5c 63 0a 2e 5c 7d 0a 2e 69 66 h'|0u'\c..\}..if
1140: 20 5c 5c 6e 28 5e 76 20 5c 7b 5c 0a 2e 6e 72 20 \\n(^v \{\..nr
1150: 5e 78 20 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c ^x \\n(^tu+1v-\\
1160: 6e 28 5e 59 75 0a 5c 6b 78 5c 68 27 2d 5c 5c 6e n(^Yu.\kx\h'-\\n
1170: 78 75 27 5c 68 27 7c 5c 5c 6e 28 5e 6c 75 2b 33 xu'\h'|\\n(^lu+3
1180: 6e 27 5c 6b 79 5c 4c 27 2d 5c 5c 6e 28 5e 78 75 n'\ky\L'-\\n(^xu
1190: 27 5c 76 27 5c 5c 6e 28 5e 78 75 27 5c 68 27 7c '\v'\\n(^xu'\h'|
11a0: 30 75 27 5c 63 0a 2e 5c 7d 0a 2e 62 70 0a 27 66 0u'\c..\}..bp.'f
11b0: 69 0a 2e 65 76 0a 2e 69 66 20 5c 5c 6e 28 5e 62 i..ev..if \\n(^b
11c0: 20 5c 7b 5c 0a 2e 6d 6b 20 5e 79 0a 2e 6e 72 20 \{\..mk ^y..nr
11d0: 5e 62 20 32 0a 2e 5c 7d 0a 2e 69 66 20 5c 5c 6e ^b 2..\}..if \\n
11e0: 28 5e 76 20 5c 7b 5c 0a 2e 6d 6b 20 5e 59 0a 2e (^v \{\..mk ^Y..
11f0: 5c 7d 0a 2e 2e 0a 2e 5c 22 09 23 20 44 53 20 2d \}.....\".# DS -
1200: 20 62 65 67 69 6e 20 64 69 73 70 6c 61 79 0a 2e begin display..
1210: 64 65 20 44 53 0a 2e 52 53 0a 2e 6e 66 0a 2e 73 de DS..RS..nf..s
1220: 70 0a 2e 2e 0a 2e 5c 22 09 23 20 44 45 20 2d 20 p.....\".# DE -
1230: 65 6e 64 20 64 69 73 70 6c 61 79 0a 2e 64 65 20 end display..de
1240: 44 45 0a 2e 66 69 0a 2e 52 45 0a 2e 73 70 0a 2e DE..fi..RE..sp..
1250: 2e 0a 2e 5c 22 09 23 20 53 4f 20 2d 20 73 74 61 ...\".# SO - sta
1260: 72 74 20 6f 66 20 6c 69 73 74 20 6f 66 20 73 74 rt of list of st
1270: 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 0a 2e andard options..
1280: 64 65 20 53 4f 0a 27 69 65 20 27 5c 5c 24 31 27 de SO.'ie '\\$1'
1290: 27 20 2e 64 73 20 53 6f 20 5c 5c 66 42 6f 70 74 ' .ds So \\fBopt
12a0: 69 6f 6e 73 5c 5c 66 52 0a 27 65 6c 20 2e 64 73 ions\\fR.'el .ds
12b0: 20 53 6f 20 5c 5c 66 42 5c 5c 24 31 5c 5c 66 52 So \\fB\\$1\\fR
12c0: 0a 2e 53 48 20 22 53 54 41 4e 44 41 52 44 20 4f ..SH "STANDARD O
12d0: 50 54 49 4f 4e 53 22 0a 2e 4c 50 0a 2e 6e 66 0a PTIONS"..LP..nf.
12e0: 2e 74 61 20 35 2e 35 63 20 31 31 63 0a 2e 66 74 .ta 5.5c 11c..ft
12f0: 20 42 0a 2e 2e 0a 2e 5c 22 09 23 20 53 45 20 2d B.....\".# SE -
1300: 20 65 6e 64 20 6f 66 20 6c 69 73 74 20 6f 66 20 end of list of
1310: 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 standard options
1320: 0a 2e 64 65 20 53 45 0a 2e 66 69 0a 2e 66 74 20 ..de SE..fi..ft
1330: 52 0a 2e 4c 50 0a 53 65 65 20 74 68 65 20 5c 5c R..LP.See the \\
1340: 2a 28 53 6f 20 6d 61 6e 75 61 6c 20 65 6e 74 72 *(So manual entr
1350: 79 20 66 6f 72 20 64 65 74 61 69 6c 73 20 6f 6e y for details on
1360: 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 6f 70 the standard op
1370: 74 69 6f 6e 73 2e 0a 2e 2e 0a 2e 5c 22 09 23 20 tions......\".#
1380: 4f 50 20 2d 20 73 74 61 72 74 20 6f 66 20 66 75 OP - start of fu
1390: 6c 6c 20 64 65 73 63 72 69 70 74 69 6f 6e 20 66 ll description f
13a0: 6f 72 20 61 20 73 69 6e 67 6c 65 20 6f 70 74 69 or a single opti
13b0: 6f 6e 0a 2e 64 65 20 4f 50 0a 2e 4c 50 0a 2e 6e on..de OP..LP..n
13c0: 66 0a 2e 74 61 20 34 63 0a 43 6f 6d 6d 61 6e 64 f..ta 4c.Command
13d0: 2d 4c 69 6e 65 20 4e 61 6d 65 3a 09 5c 5c 66 42 -Line Name:.\\fB
13e0: 5c 5c 24 31 5c 5c 66 52 0a 44 61 74 61 62 61 73 \\$1\\fR.Databas
13f0: 65 20 4e 61 6d 65 3a 09 5c 5c 66 42 5c 5c 24 32 e Name:.\\fB\\$2
1400: 5c 5c 66 52 0a 44 61 74 61 62 61 73 65 20 43 6c \\fR.Database Cl
1410: 61 73 73 3a 09 5c 5c 66 42 5c 5c 24 33 5c 5c 66 ass:.\\fB\\$3\\f
1420: 52 0a 2e 66 69 0a 2e 49 50 0a 2e 2e 0a 2e 5c 22 R..fi..IP.....\"
1430: 09 23 20 43 53 20 2d 20 62 65 67 69 6e 20 63 6f .# CS - begin co
1440: 64 65 20 65 78 63 65 72 70 74 0a 2e 64 65 20 43 de excerpt..de C
1450: 53 0a 2e 52 53 0a 2e 6e 66 0a 2e 74 61 20 2e 32 S..RS..nf..ta .2
1460: 35 69 20 2e 35 69 20 2e 37 35 69 20 31 69 0a 2e 5i .5i .75i 1i..
1470: 2e 0a 2e 5c 22 09 23 20 43 45 20 2d 20 65 6e 64 ...\".# CE - end
1480: 20 63 6f 64 65 20 65 78 63 65 72 70 74 0a 2e 64 code excerpt..d
1490: 65 20 43 45 0a 2e 66 69 0a 2e 52 45 0a 2e 2e 0a e CE..fi..RE....
14a0: 2e 5c 22 09 23 20 55 4c 20 2d 20 75 6e 64 65 72 .\".# UL - under
14b0: 6c 69 6e 65 20 77 6f 72 64 0a 2e 64 65 20 55 4c line word..de UL
14c0: 0a 5c 5c 24 31 5c 6c 27 7c 30 5c 28 75 6c 27 5c .\\$1\l'|0\(ul'\
14d0: 5c 24 32 0a 2e 2e 0a 2e 5c 22 09 23 20 51 57 20 \$2.....\".# QW
14e0: 2d 20 61 70 70 6c 79 20 71 75 6f 74 61 74 69 6f - apply quotatio
14f0: 6e 20 6d 61 72 6b 73 20 74 6f 20 77 6f 72 64 0a n marks to word.
1500: 2e 64 65 20 51 57 0a 2e 69 65 20 27 5c 5c 2a 28 .de QW..ie '\\*(
1510: 6c 71 27 22 27 20 60 60 5c 5c 24 31 27 27 5c 5c lq'"' ``\\$1''\\
1520: 24 32 0a 2e 5c 22 22 20 66 69 78 20 65 6d 61 63 $2..\"" fix emac
1530: 73 20 68 69 67 68 6c 69 67 68 74 69 6e 67 0a 2e s highlighting..
1540: 65 6c 20 5c 5c 2a 28 6c 71 5c 5c 24 31 5c 5c 2a el \\*(lq\\$1\\*
1550: 28 72 71 5c 5c 24 32 0a 2e 2e 0a 2e 5c 22 09 23 (rq\\$2.....\".#
1560: 20 50 51 20 2d 20 61 70 70 6c 79 20 70 61 72 65 PQ - apply pare
1570: 6e 73 20 61 6e 64 20 71 75 6f 74 61 74 69 6f 6e ns and quotation
1580: 20 6d 61 72 6b 73 20 74 6f 20 77 6f 72 64 0a 2e marks to word..
1590: 64 65 20 50 51 0a 2e 69 65 20 27 5c 5c 2a 28 6c de PQ..ie '\\*(l
15a0: 71 27 22 27 20 28 60 60 5c 5c 24 31 27 27 5c 5c q'"' (``\\$1''\\
15b0: 24 32 29 5c 5c 24 33 0a 2e 5c 22 22 20 66 69 78 $2)\\$3..\"" fix
15c0: 20 65 6d 61 63 73 20 68 69 67 68 6c 69 67 68 74 emacs highlight
15d0: 69 6e 67 0a 2e 65 6c 20 28 5c 5c 2a 28 6c 71 5c ing..el (\\*(lq\
15e0: 5c 24 31 5c 5c 2a 28 72 71 5c 5c 24 32 29 5c 5c \$1\\*(rq\\$2)\\
15f0: 24 33 0a 2e 2e 0a 2e 5c 22 09 23 20 51 52 20 2d $3.....\".# QR -
1600: 20 71 75 6f 74 65 64 20 72 61 6e 67 65 0a 2e 64 quoted range..d
1610: 65 20 51 52 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 e QR..ie '\\*(lq
1620: 27 22 27 20 60 60 5c 5c 24 31 27 27 5c 5c 2d 60 '"' ``\\$1''\\-`
1630: 60 5c 5c 24 32 27 27 5c 5c 24 33 0a 2e 5c 22 22 `\\$2''\\$3..\""
1640: 20 66 69 78 20 65 6d 61 63 73 20 68 69 67 68 6c fix emacs highl
1650: 69 67 68 74 69 6e 67 0a 2e 65 6c 20 5c 5c 2a 28 ighting..el \\*(
1660: 6c 71 5c 5c 24 31 5c 5c 2a 28 72 71 5c 5c 2d 5c lq\\$1\\*(rq\\-\
1670: 5c 2a 28 6c 71 5c 5c 24 32 5c 5c 2a 28 72 71 5c \*(lq\\$2\\*(rq\
1680: 5c 24 33 0a 2e 2e 0a 2e 5c 22 09 23 20 4d 54 20 \$3.....\".# MT
1690: 2d 20 22 65 6d 70 74 79 22 20 73 74 72 69 6e 67 - "empty" string
16a0: 0a 2e 64 65 20 4d 54 0a 2e 51 57 20 22 22 0a 2e ..de MT..QW ""..
16b0: 2e 0a ..
