Artifact
1d639b8f738363ab563d1b7e363e1bd084218bb8:
0000: 27 5c 22 0a 27 5c 22 20 47 65 6e 65 72 61 74 65 '\".'\" Generate
0010: 64 20 66 72 6f 6d 20 66 69 6c 65 20 27 63 6d 64 d from file 'cmd
0020: 72 5f 76 74 5f 74 69 6d 65 5c 26 2e 6d 61 6e 27 r_vt_time\&.man'
0030: 20 62 79 20 74 63 6c 6c 69 62 2f 64 6f 63 74 6f by tcllib/docto
0040: 6f 6c 73 20 77 69 74 68 20 66 6f 72 6d 61 74 20 ols with format
0050: 27 6e 72 6f 66 66 27 0a 27 5c 22 20 43 6f 70 79 'nroff'.'\" Copy
0060: 72 69 67 68 74 20 28 63 29 20 32 30 31 33 2d 32 right (c) 2013-2
0070: 30 31 36 20 41 6e 64 72 65 61 73 20 4b 75 70 72 016 Andreas Kupr
0080: 69 65 73 0a 27 5c 22 20 43 6f 70 79 72 69 67 68 ies.'\" Copyrigh
0090: 74 20 28 63 29 20 32 30 31 33 2d 32 30 31 36 20 t (c) 2013-2016
00a0: 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 41 Documentation, A
00b0: 6e 64 72 65 61 73 20 4b 75 70 72 69 65 73 0a 27 ndreas Kupries.'
00c0: 5c 22 0a 2e 54 48 20 22 63 6d 64 72 3a 3a 76 61 \"..TH "cmdr::va
00d0: 6c 69 64 61 74 65 3a 3a 74 69 6d 65 22 20 6e 20 lidate::time" n
00e0: 31 20 64 6f 63 20 22 43 6d 64 72 2c 20 61 20 66 1 doc "Cmdr, a f
00f0: 72 61 6d 65 77 6f 72 6b 20 66 6f 72 20 63 6f 6d ramework for com
0100: 6d 61 6e 64 20 6c 69 6e 65 20 70 61 72 73 69 6e mand line parsin
0110: 67 20 61 6e 64 20 64 69 73 70 61 74 63 68 22 0a g and dispatch".
0120: 2e 5c 22 20 54 68 65 20 2d 2a 2d 20 6e 72 6f 66 .\" The -*- nrof
0130: 66 20 2d 2a 2d 20 64 65 66 69 6e 69 74 69 6f 6e f -*- definition
0140: 73 20 62 65 6c 6f 77 20 61 72 65 20 66 6f 72 20 s below are for
0150: 73 75 70 70 6c 65 6d 65 6e 74 61 6c 20 6d 61 63 supplemental mac
0160: 72 6f 73 20 75 73 65 64 0a 2e 5c 22 20 69 6e 20 ros used..\" in
0170: 54 63 6c 2f 54 6b 20 6d 61 6e 75 61 6c 20 65 6e Tcl/Tk manual en
0180: 74 72 69 65 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e tries...\"..\" .
0190: 41 50 20 74 79 70 65 20 6e 61 6d 65 20 69 6e 2f AP type name in/
01a0: 6f 75 74 20 3f 69 6e 64 65 6e 74 3f 0a 2e 5c 22 out ?indent?..\"
01b0: 09 53 74 61 72 74 20 70 61 72 61 67 72 61 70 68 .Start paragraph
01c0: 20 64 65 73 63 72 69 62 69 6e 67 20 61 6e 20 61 describing an a
01d0: 72 67 75 6d 65 6e 74 20 74 6f 20 61 20 6c 69 62 rgument to a lib
01e0: 72 61 72 79 20 70 72 6f 63 65 64 75 72 65 2e 0a rary procedure..
01f0: 2e 5c 22 09 74 79 70 65 20 69 73 20 74 79 70 65 .\".type is type
0200: 20 6f 66 20 61 72 67 75 6d 65 6e 74 20 28 69 6e of argument (in
0210: 74 2c 20 65 74 63 2e 29 2c 20 69 6e 2f 6f 75 74 t, etc.), in/out
0220: 20 69 73 20 65 69 74 68 65 72 20 22 69 6e 22 2c is either "in",
0230: 20 22 6f 75 74 22 2c 0a 2e 5c 22 09 6f 72 20 22 "out",..\".or "
0240: 69 6e 2f 6f 75 74 22 20 74 6f 20 64 65 73 63 72 in/out" to descr
0250: 69 62 65 20 77 68 65 74 68 65 72 20 70 72 6f 63 ibe whether proc
0260: 65 64 75 72 65 20 72 65 61 64 73 20 6f 72 20 6d edure reads or m
0270: 6f 64 69 66 69 65 73 20 61 72 67 2c 0a 2e 5c 22 odifies arg,..\"
0280: 09 61 6e 64 20 69 6e 64 65 6e 74 20 69 73 20 65 .and indent is e
0290: 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 73 65 63 quivalent to sec
02a0: 6f 6e 64 20 61 72 67 20 6f 66 20 2e 49 50 20 28 ond arg of .IP (
02b0: 73 68 6f 75 6c 64 6e 27 74 20 65 76 65 72 20 62 shouldn't ever b
02c0: 65 0a 2e 5c 22 09 6e 65 65 64 65 64 3b 20 20 75 e..\".needed; u
02d0: 73 65 20 2e 41 53 20 62 65 6c 6f 77 20 69 6e 73 se .AS below ins
02e0: 74 65 61 64 29 0a 2e 5c 22 0a 2e 5c 22 20 2e 41 tead)..\"..\" .A
02f0: 53 20 3f 74 79 70 65 3f 20 3f 6e 61 6d 65 3f 0a S ?type? ?name?.
0300: 2e 5c 22 09 47 69 76 65 20 6d 61 78 69 6d 75 6d .\".Give maximum
0310: 20 73 69 7a 65 73 20 6f 66 20 61 72 67 75 6d 65 sizes of argume
0320: 6e 74 73 20 66 6f 72 20 73 65 74 74 69 6e 67 20 nts for setting
0330: 74 61 62 20 73 74 6f 70 73 2e 20 20 54 79 70 65 tab stops. Type
0340: 20 61 6e 64 0a 2e 5c 22 09 6e 61 6d 65 20 61 72 and..\".name ar
0350: 65 20 65 78 61 6d 70 6c 65 73 20 6f 66 20 6c 61 e examples of la
0360: 72 67 65 73 74 20 70 6f 73 73 69 62 6c 65 20 61 rgest possible a
0370: 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 77 69 rguments that wi
0380: 6c 6c 20 62 65 20 70 61 73 73 65 64 0a 2e 5c 22 ll be passed..\"
0390: 09 74 6f 20 2e 41 50 20 6c 61 74 65 72 2e 20 20 .to .AP later.
03a0: 49 66 20 61 72 67 73 20 61 72 65 20 6f 6d 69 74 If args are omit
03b0: 74 65 64 2c 20 64 65 66 61 75 6c 74 20 74 61 62 ted, default tab
03c0: 20 73 74 6f 70 73 20 61 72 65 20 75 73 65 64 2e stops are used.
03d0: 0a 2e 5c 22 0a 2e 5c 22 20 2e 42 53 0a 2e 5c 22 ..\"..\" .BS..\"
03e0: 09 53 74 61 72 74 20 62 6f 78 20 65 6e 63 6c 6f .Start box enclo
03f0: 73 75 72 65 2e 20 20 46 72 6f 6d 20 68 65 72 65 sure. From here
0400: 20 75 6e 74 69 6c 20 6e 65 78 74 20 2e 42 45 2c until next .BE,
0410: 20 65 76 65 72 79 74 68 69 6e 67 20 77 69 6c 6c everything will
0420: 20 62 65 0a 2e 5c 22 09 65 6e 63 6c 6f 73 65 64 be..\".enclosed
0430: 20 69 6e 20 6f 6e 65 20 6c 61 72 67 65 20 62 6f in one large bo
0440: 78 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 42 45 0a 2e x...\"..\" .BE..
0450: 5c 22 09 45 6e 64 20 6f 66 20 62 6f 78 20 65 6e \".End of box en
0460: 63 6c 6f 73 75 72 65 2e 0a 2e 5c 22 0a 2e 5c 22 closure...\"..\"
0470: 20 2e 43 53 0a 2e 5c 22 09 42 65 67 69 6e 20 63 .CS..\".Begin c
0480: 6f 64 65 20 65 78 63 65 72 70 74 2e 0a 2e 5c 22 ode excerpt...\"
0490: 0a 2e 5c 22 20 2e 43 45 0a 2e 5c 22 09 45 6e 64 ..\" .CE..\".End
04a0: 20 63 6f 64 65 20 65 78 63 65 72 70 74 2e 0a 2e code excerpt...
04b0: 5c 22 0a 2e 5c 22 20 2e 56 53 20 3f 76 65 72 73 \"..\" .VS ?vers
04c0: 69 6f 6e 3f 20 3f 62 72 3f 0a 2e 5c 22 09 42 65 ion? ?br?..\".Be
04d0: 67 69 6e 20 76 65 72 74 69 63 61 6c 20 73 69 64 gin vertical sid
04e0: 65 62 61 72 2c 20 66 6f 72 20 75 73 65 20 69 6e ebar, for use in
04f0: 20 6d 61 72 6b 69 6e 67 20 6e 65 77 6c 79 2d 63 marking newly-c
0500: 68 61 6e 67 65 64 20 70 61 72 74 73 0a 2e 5c 22 hanged parts..\"
0510: 09 6f 66 20 6d 61 6e 20 70 61 67 65 73 2e 20 20 .of man pages.
0520: 54 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 The first argume
0530: 6e 74 20 69 73 20 69 67 6e 6f 72 65 64 20 61 6e nt is ignored an
0540: 64 20 75 73 65 64 20 66 6f 72 20 72 65 63 6f 72 d used for recor
0550: 64 69 6e 67 0a 2e 5c 22 09 74 68 65 20 76 65 72 ding..\".the ver
0560: 73 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 2e 56 sion when the .V
0570: 53 20 77 61 73 20 61 64 64 65 64 2c 20 73 6f 20 S was added, so
0580: 74 68 61 74 20 74 68 65 20 73 69 64 65 62 61 72 that the sidebar
0590: 73 20 63 61 6e 20 62 65 0a 2e 5c 22 09 66 6f 75 s can be..\".fou
05a0: 6e 64 20 61 6e 64 20 72 65 6d 6f 76 65 64 20 77 nd and removed w
05b0: 68 65 6e 20 74 68 65 79 20 72 65 61 63 68 20 61 hen they reach a
05c0: 20 63 65 72 74 61 69 6e 20 61 67 65 2e 20 20 49 certain age. I
05d0: 66 20 61 6e 6f 74 68 65 72 20 61 72 67 75 6d 65 f another argume
05e0: 6e 74 0a 2e 5c 22 09 69 73 20 70 72 65 73 65 6e nt..\".is presen
05f0: 74 2c 20 74 68 65 6e 20 61 20 6c 69 6e 65 20 62 t, then a line b
0600: 72 65 61 6b 20 69 73 20 66 6f 72 63 65 64 20 62 reak is forced b
0610: 65 66 6f 72 65 20 73 74 61 72 74 69 6e 67 20 74 efore starting t
0620: 68 65 20 73 69 64 65 62 61 72 2e 0a 2e 5c 22 0a he sidebar...\".
0630: 2e 5c 22 20 2e 56 45 0a 2e 5c 22 09 45 6e 64 20 .\" .VE..\".End
0640: 6f 66 20 76 65 72 74 69 63 61 6c 20 73 69 64 65 of vertical side
0650: 62 61 72 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 44 53 bar...\"..\" .DS
0660: 0a 2e 5c 22 09 42 65 67 69 6e 20 61 6e 20 69 6e ..\".Begin an in
0670: 64 65 6e 74 65 64 20 75 6e 66 69 6c 6c 65 64 20 dented unfilled
0680: 64 69 73 70 6c 61 79 2e 0a 2e 5c 22 0a 2e 5c 22 display...\"..\"
0690: 20 2e 44 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 .DE..\".End of
06a0: 69 6e 64 65 6e 74 65 64 20 75 6e 66 69 6c 6c 65 indented unfille
06b0: 64 20 64 69 73 70 6c 61 79 2e 0a 2e 5c 22 0a 2e d display...\"..
06c0: 5c 22 20 2e 53 4f 20 3f 6d 61 6e 70 61 67 65 3f \" .SO ?manpage?
06d0: 0a 2e 5c 22 09 53 74 61 72 74 20 6f 66 20 6c 69 ..\".Start of li
06e0: 73 74 20 6f 66 20 73 74 61 6e 64 61 72 64 20 6f st of standard o
06f0: 70 74 69 6f 6e 73 20 66 6f 72 20 61 20 54 6b 20 ptions for a Tk
0700: 77 69 64 67 65 74 2e 20 54 68 65 20 6d 61 6e 70 widget. The manp
0710: 61 67 65 0a 2e 5c 22 09 61 72 67 75 6d 65 6e 74 age..\".argument
0720: 20 64 65 66 69 6e 65 73 20 77 68 65 72 65 20 74 defines where t
0730: 6f 20 6c 6f 6f 6b 20 75 70 20 74 68 65 20 73 74 o look up the st
0740: 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 3b 20 andard options;
0750: 69 66 0a 2e 5c 22 09 6f 6d 69 74 74 65 64 2c 20 if..\".omitted,
0760: 64 65 66 61 75 6c 74 73 20 74 6f 20 22 6f 70 74 defaults to "opt
0770: 69 6f 6e 73 22 2e 20 54 68 65 20 6f 70 74 69 6f ions". The optio
0780: 6e 73 20 66 6f 6c 6c 6f 77 20 6f 6e 20 73 75 63 ns follow on suc
0790: 63 65 73 73 69 76 65 0a 2e 5c 22 09 6c 69 6e 65 cessive..\".line
07a0: 73 2c 20 69 6e 20 74 68 72 65 65 20 63 6f 6c 75 s, in three colu
07b0: 6d 6e 73 20 73 65 70 61 72 61 74 65 64 20 62 79 mns separated by
07c0: 20 74 61 62 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e tabs...\"..\" .
07d0: 53 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 6c 69 SE..\".End of li
07e0: 73 74 20 6f 66 20 73 74 61 6e 64 61 72 64 20 6f st of standard o
07f0: 70 74 69 6f 6e 73 20 66 6f 72 20 61 20 54 6b 20 ptions for a Tk
0800: 77 69 64 67 65 74 2e 0a 2e 5c 22 0a 2e 5c 22 20 widget...\"..\"
0810: 2e 4f 50 20 63 6d 64 4e 61 6d 65 20 64 62 4e 61 .OP cmdName dbNa
0820: 6d 65 20 64 62 43 6c 61 73 73 0a 2e 5c 22 09 53 me dbClass..\".S
0830: 74 61 72 74 20 6f 66 20 64 65 73 63 72 69 70 74 tart of descript
0840: 69 6f 6e 20 6f 66 20 61 20 73 70 65 63 69 66 69 ion of a specifi
0850: 63 20 6f 70 74 69 6f 6e 2e 20 20 63 6d 64 4e 61 c option. cmdNa
0860: 6d 65 20 67 69 76 65 73 20 74 68 65 0a 2e 5c 22 me gives the..\"
0870: 09 6f 70 74 69 6f 6e 27 73 20 6e 61 6d 65 20 61 .option's name a
0880: 73 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 s specified in t
0890: 68 65 20 63 6c 61 73 73 20 63 6f 6d 6d 61 6e 64 he class command
08a0: 2c 20 64 62 4e 61 6d 65 20 67 69 76 65 73 0a 2e , dbName gives..
08b0: 5c 22 09 74 68 65 20 6f 70 74 69 6f 6e 27 73 20 \".the option's
08c0: 6e 61 6d 65 20 69 6e 20 74 68 65 20 6f 70 74 69 name in the opti
08d0: 6f 6e 20 64 61 74 61 62 61 73 65 2c 20 61 6e 64 on database, and
08e0: 20 64 62 43 6c 61 73 73 20 67 69 76 65 73 0a 2e dbClass gives..
08f0: 5c 22 09 74 68 65 20 6f 70 74 69 6f 6e 27 73 20 \".the option's
0900: 63 6c 61 73 73 20 69 6e 20 74 68 65 20 6f 70 74 class in the opt
0910: 69 6f 6e 20 64 61 74 61 62 61 73 65 2e 0a 2e 5c ion database...\
0920: 22 0a 2e 5c 22 20 2e 55 4c 20 61 72 67 31 20 61 "..\" .UL arg1 a
0930: 72 67 32 0a 2e 5c 22 09 50 72 69 6e 74 20 61 72 rg2..\".Print ar
0940: 67 31 20 75 6e 64 65 72 6c 69 6e 65 64 2c 20 74 g1 underlined, t
0950: 68 65 6e 20 70 72 69 6e 74 20 61 72 67 32 20 6e hen print arg2 n
0960: 6f 72 6d 61 6c 6c 79 2e 0a 2e 5c 22 0a 2e 5c 22 ormally...\"..\"
0970: 20 2e 51 57 20 61 72 67 31 20 3f 61 72 67 32 3f .QW arg1 ?arg2?
0980: 0a 2e 5c 22 09 50 72 69 6e 74 20 61 72 67 31 20 ..\".Print arg1
0990: 69 6e 20 71 75 6f 74 65 73 2c 20 74 68 65 6e 20 in quotes, then
09a0: 61 72 67 32 20 6e 6f 72 6d 61 6c 6c 79 20 28 66 arg2 normally (f
09b0: 6f 72 20 74 72 61 69 6c 69 6e 67 20 70 75 6e 63 or trailing punc
09c0: 74 75 61 74 69 6f 6e 29 2e 0a 2e 5c 22 0a 2e 5c tuation)...\"..\
09d0: 22 20 2e 50 51 20 61 72 67 31 20 3f 61 72 67 32 " .PQ arg1 ?arg2
09e0: 3f 0a 2e 5c 22 09 50 72 69 6e 74 20 61 6e 20 6f ?..\".Print an o
09f0: 70 65 6e 20 70 61 72 65 6e 74 68 65 73 69 73 2c pen parenthesis,
0a00: 20 61 72 67 31 20 69 6e 20 71 75 6f 74 65 73 2c arg1 in quotes,
0a10: 20 74 68 65 6e 20 61 72 67 32 20 6e 6f 72 6d 61 then arg2 norma
0a20: 6c 6c 79 0a 2e 5c 22 09 28 66 6f 72 20 74 72 61 lly..\".(for tra
0a30: 69 6c 69 6e 67 20 70 75 6e 63 74 75 61 74 69 6f iling punctuatio
0a40: 6e 29 20 61 6e 64 20 74 68 65 6e 20 61 20 63 6c n) and then a cl
0a50: 6f 73 69 6e 67 20 70 61 72 65 6e 74 68 65 73 69 osing parenthesi
0a60: 73 2e 0a 2e 5c 22 0a 2e 5c 22 09 23 20 53 65 74 s...\"..\".# Set
0a70: 20 75 70 20 74 72 61 70 73 20 61 6e 64 20 6f 74 up traps and ot
0a80: 68 65 72 20 6d 69 73 63 65 6c 6c 61 6e 65 6f 75 her miscellaneou
0a90: 73 20 73 74 75 66 66 20 66 6f 72 20 54 63 6c 2f s stuff for Tcl/
0aa0: 54 6b 20 6d 61 6e 20 70 61 67 65 73 2e 0a 2e 69 Tk man pages...i
0ab0: 66 20 74 20 2e 77 68 20 2d 31 2e 33 69 20 5e 42 f t .wh -1.3i ^B
0ac0: 0a 2e 6e 72 20 5e 6c 20 5c 6e 28 2e 6c 0a 2e 61 ..nr ^l \n(.l..a
0ad0: 64 20 62 0a 2e 5c 22 09 23 20 53 74 61 72 74 20 d b..\".# Start
0ae0: 61 6e 20 61 72 67 75 6d 65 6e 74 20 64 65 73 63 an argument desc
0af0: 72 69 70 74 69 6f 6e 0a 2e 64 65 20 41 50 0a 2e ription..de AP..
0b00: 69 65 20 21 22 5c 5c 24 34 22 22 20 2e 54 50 20 ie !"\\$4"" .TP
0b10: 5c 5c 24 34 0a 2e 65 6c 20 5c 7b 5c 0a 2e 20 20 \\$4..el \{\..
0b20: 20 69 65 20 21 22 5c 5c 24 32 22 22 20 2e 54 50 ie !"\\$2"" .TP
0b30: 20 5c 5c 6e 28 29 43 75 0a 2e 20 20 20 65 6c 20 \\n()Cu.. el
0b40: 20 20 20 20 20 20 20 20 20 2e 54 50 20 31 35 0a .TP 15.
0b50: 2e 5c 7d 0a 2e 74 61 20 5c 5c 6e 28 29 41 75 20 .\}..ta \\n()Au
0b60: 5c 5c 6e 28 29 42 75 0a 2e 69 65 20 21 22 5c 5c \\n()Bu..ie !"\\
0b70: 24 33 22 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 31 20 $3"" \{\.\&\\$1
0b80: 5c 5c 66 49 5c 5c 24 32 5c 5c 66 50 20 28 5c 5c \\fI\\$2\\fP (\\
0b90: 24 33 29 0a 2e 5c 22 2e 62 0a 2e 5c 7d 0a 2e 65 $3)..\".b..\}..e
0ba0: 6c 20 5c 7b 5c 0a 2e 62 72 0a 2e 69 65 20 21 22 l \{\..br..ie !"
0bb0: 5c 5c 24 32 22 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 \\$2"" \{\.\&\\$
0bc0: 31 09 5c 5c 66 49 5c 5c 24 32 5c 5c 66 50 0a 2e 1.\\fI\\$2\\fP..
0bd0: 5c 7d 0a 2e 65 6c 20 5c 7b 5c 0a 5c 26 5c 5c 66 \}..el \{\.\&\\f
0be0: 49 5c 5c 24 31 5c 5c 66 50 0a 2e 5c 7d 0a 2e 5c I\\$1\\fP..\}..\
0bf0: 7d 0a 2e 2e 0a 2e 5c 22 09 23 20 64 65 66 69 6e }.....\".# defin
0c00: 65 20 74 61 62 62 69 6e 67 20 76 61 6c 75 65 73 e tabbing values
0c10: 20 66 6f 72 20 2e 41 50 0a 2e 64 65 20 41 53 0a for .AP..de AS.
0c20: 2e 6e 72 20 29 41 20 31 30 6e 0a 2e 69 66 20 21 .nr )A 10n..if !
0c30: 22 5c 5c 24 31 22 22 20 2e 6e 72 20 29 41 20 5c "\\$1"" .nr )A \
0c40: 5c 77 27 5c 5c 24 31 27 75 2b 33 6e 0a 2e 6e 72 \w'\\$1'u+3n..nr
0c50: 20 29 42 20 5c 5c 6e 28 29 41 75 2b 31 35 6e 0a )B \\n()Au+15n.
0c60: 2e 5c 22 0a 2e 69 66 20 21 22 5c 5c 24 32 22 22 .\"..if !"\\$2""
0c70: 20 2e 6e 72 20 29 42 20 5c 5c 77 27 5c 5c 24 32 .nr )B \\w'\\$2
0c80: 27 75 2b 5c 5c 6e 28 29 41 75 2b 33 6e 0a 2e 6e 'u+\\n()Au+3n..n
0c90: 72 20 29 43 20 5c 5c 6e 28 29 42 75 2b 5c 5c 77 r )C \\n()Bu+\\w
0ca0: 27 28 69 6e 2f 6f 75 74 29 27 75 2b 32 6e 0a 2e '(in/out)'u+2n..
0cb0: 2e 0a 2e 41 53 20 54 63 6c 5f 49 6e 74 65 72 70 ...AS Tcl_Interp
0cc0: 20 54 63 6c 5f 43 72 65 61 74 65 49 6e 74 65 72 Tcl_CreateInter
0cd0: 70 20 69 6e 2f 6f 75 74 0a 2e 5c 22 09 23 20 42 p in/out..\".# B
0ce0: 53 20 2d 20 73 74 61 72 74 20 62 6f 78 65 64 20 S - start boxed
0cf0: 74 65 78 74 0a 2e 5c 22 09 23 20 5e 79 20 3d 20 text..\".# ^y =
0d00: 73 74 61 72 74 69 6e 67 20 79 20 6c 6f 63 61 74 starting y locat
0d10: 69 6f 6e 0a 2e 5c 22 09 23 20 5e 62 20 3d 20 31 ion..\".# ^b = 1
0d20: 0a 2e 64 65 20 42 53 0a 2e 62 72 0a 2e 6d 6b 20 ..de BS..br..mk
0d30: 5e 79 0a 2e 6e 72 20 5e 62 20 31 75 0a 2e 69 66 ^y..nr ^b 1u..if
0d40: 20 6e 20 2e 6e 66 0a 2e 69 66 20 6e 20 2e 74 69 n .nf..if n .ti
0d50: 20 30 0a 2e 69 66 20 6e 20 5c 6c 27 5c 5c 6e 28 0..if n \l'\\n(
0d60: 2e 6c 75 5c 28 75 6c 27 0a 2e 69 66 20 6e 20 2e .lu\(ul'..if n .
0d70: 66 69 0a 2e 2e 0a 2e 5c 22 09 23 20 42 45 20 2d fi.....\".# BE -
0d80: 20 65 6e 64 20 62 6f 78 65 64 20 74 65 78 74 20 end boxed text
0d90: 28 64 72 61 77 20 62 6f 78 20 6e 6f 77 29 0a 2e (draw box now)..
0da0: 64 65 20 42 45 0a 2e 6e 66 0a 2e 74 69 20 30 0a de BE..nf..ti 0.
0db0: 2e 6d 6b 20 5e 74 0a 2e 69 65 20 6e 20 5c 6c 27 .mk ^t..ie n \l'
0dc0: 5c 5c 6e 28 5e 6c 75 5c 28 75 6c 27 0a 2e 65 6c \\n(^lu\(ul'..el
0dd0: 20 5c 7b 5c 0a 2e 5c 22 09 44 72 61 77 20 66 6f \{\..\".Draw fo
0de0: 75 72 2d 73 69 64 65 64 20 62 6f 78 20 6e 6f 72 ur-sided box nor
0df0: 6d 61 6c 6c 79 2c 20 62 75 74 20 64 6f 6e 27 74 mally, but don't
0e00: 20 64 72 61 77 20 74 6f 70 20 6f 66 0a 2e 5c 22 draw top of..\"
0e10: 09 62 6f 78 20 69 66 20 74 68 65 20 62 6f 78 20 .box if the box
0e20: 73 74 61 72 74 65 64 20 6f 6e 20 61 6e 20 65 61 started on an ea
0e30: 72 6c 69 65 72 20 70 61 67 65 2e 0a 2e 69 65 20 rlier page...ie
0e40: 21 5c 5c 6e 28 5e 62 2d 31 20 5c 7b 5c 0a 5c 68 !\\n(^b-1 \{\.\h
0e50: 27 2d 31 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e '-1.5n'\L'|\\n(^
0e60: 79 75 2d 31 76 27 5c 6c 27 5c 5c 6e 28 5e 6c 75 yu-1v'\l'\\n(^lu
0e70: 2b 33 6e 5c 28 75 6c 27 5c 4c 27 5c 5c 6e 28 5e +3n\(ul'\L'\\n(^
0e80: 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27 5c 6c tu+1v-\\n(^yu'\l
0e90: 27 7c 30 75 2d 31 2e 35 6e 5c 28 75 6c 27 0a 2e '|0u-1.5n\(ul'..
0ea0: 5c 7d 0a 2e 65 6c 20 5c 7d 5c 0a 5c 68 27 2d 31 \}..el \}\.\h'-1
0eb0: 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 79 75 2d .5n'\L'|\\n(^yu-
0ec0: 31 76 27 5c 68 27 5c 5c 6e 28 5e 6c 75 2b 33 6e 1v'\h'\\n(^lu+3n
0ed0: 27 5c 4c 27 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c '\L'\\n(^tu+1v-\
0ee0: 5c 6e 28 5e 79 75 27 5c 6c 27 7c 30 75 2d 31 2e \n(^yu'\l'|0u-1.
0ef0: 35 6e 5c 28 75 6c 27 0a 2e 5c 7d 0a 2e 5c 7d 0a 5n\(ul'..\}..\}.
0f00: 2e 66 69 0a 2e 62 72 0a 2e 6e 72 20 5e 62 20 30 .fi..br..nr ^b 0
0f10: 0a 2e 2e 0a 2e 5c 22 09 23 20 56 53 20 2d 20 73 .....\".# VS - s
0f20: 74 61 72 74 20 76 65 72 74 69 63 61 6c 20 73 69 tart vertical si
0f30: 64 65 62 61 72 0a 2e 5c 22 09 23 20 5e 59 20 3d debar..\".# ^Y =
0f40: 20 73 74 61 72 74 69 6e 67 20 79 20 6c 6f 63 61 starting y loca
0f50: 74 69 6f 6e 0a 2e 5c 22 09 23 20 5e 76 20 3d 20 tion..\".# ^v =
0f60: 31 20 28 66 6f 72 20 74 72 6f 66 66 3b 20 20 66 1 (for troff; f
0f70: 6f 72 20 6e 72 6f 66 66 20 74 68 69 73 20 64 6f or nroff this do
0f80: 65 73 6e 27 74 20 6d 61 74 74 65 72 29 0a 2e 64 esn't matter)..d
0f90: 65 20 56 53 0a 2e 69 66 20 21 22 5c 5c 24 32 22 e VS..if !"\\$2"
0fa0: 22 20 2e 62 72 0a 2e 6d 6b 20 5e 59 0a 2e 69 65 " .br..mk ^Y..ie
0fb0: 20 6e 20 27 6d 63 20 5c 73 31 32 5c 28 62 72 5c n 'mc \s12\(br\
0fc0: 73 30 0a 2e 65 6c 20 2e 6e 72 20 5e 76 20 31 75 s0..el .nr ^v 1u
0fd0: 0a 2e 2e 0a 2e 5c 22 09 23 20 56 45 20 2d 20 65 .....\".# VE - e
0fe0: 6e 64 20 6f 66 20 76 65 72 74 69 63 61 6c 20 73 nd of vertical s
0ff0: 69 64 65 62 61 72 0a 2e 64 65 20 56 45 0a 2e 69 idebar..de VE..i
1000: 65 20 6e 20 27 6d 63 0a 2e 65 6c 20 5c 7b 5c 0a e n 'mc..el \{\.
1010: 2e 65 76 20 32 0a 2e 6e 66 0a 2e 74 69 20 30 0a .ev 2..nf..ti 0.
1020: 2e 6d 6b 20 5e 74 0a 5c 68 27 7c 5c 5c 6e 28 5e .mk ^t.\h'|\\n(^
1030: 6c 75 2b 33 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 59 lu+3n'\L'|\\n(^Y
1040: 75 2d 31 76 5c 28 62 76 27 5c 76 27 5c 5c 6e 28 u-1v\(bv'\v'\\n(
1050: 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 59 75 27 5c ^tu+1v-\\n(^Yu'\
1060: 68 27 2d 7c 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 0a h'-|\\n(^lu+3n'.
1070: 2e 73 70 20 2d 31 0a 2e 66 69 0a 2e 65 76 0a 2e .sp -1..fi..ev..
1080: 5c 7d 0a 2e 6e 72 20 5e 76 20 30 0a 2e 2e 0a 2e \}..nr ^v 0.....
1090: 5c 22 09 23 20 53 70 65 63 69 61 6c 20 6d 61 63 \".# Special mac
10a0: 72 6f 20 74 6f 20 68 61 6e 64 6c 65 20 70 61 67 ro to handle pag
10b0: 65 20 62 6f 74 74 6f 6d 3a 20 20 66 69 6e 69 73 e bottom: finis
10c0: 68 20 6f 66 66 20 63 75 72 72 65 6e 74 0a 2e 5c h off current..\
10d0: 22 09 23 20 62 6f 78 2f 73 69 64 65 62 61 72 20 ".# box/sidebar
10e0: 69 66 20 69 6e 20 62 6f 78 2f 73 69 64 65 62 61 if in box/sideba
10f0: 72 20 6d 6f 64 65 2c 20 74 68 65 6e 20 69 6e 76 r mode, then inv
1100: 6f 6b 65 64 20 73 74 61 6e 64 61 72 64 0a 2e 5c oked standard..\
1110: 22 09 23 20 70 61 67 65 20 62 6f 74 74 6f 6d 20 ".# page bottom
1120: 6d 61 63 72 6f 2e 0a 2e 64 65 20 5e 42 0a 2e 65 macro...de ^B..e
1130: 76 20 32 0a 27 74 69 20 30 0a 27 6e 66 0a 2e 6d v 2.'ti 0.'nf..m
1140: 6b 20 5e 74 0a 2e 69 66 20 5c 5c 6e 28 5e 62 20 k ^t..if \\n(^b
1150: 5c 7b 5c 0a 2e 5c 22 09 44 72 61 77 20 74 68 72 \{\..\".Draw thr
1160: 65 65 2d 73 69 64 65 64 20 62 6f 78 20 69 66 20 ee-sided box if
1170: 74 68 69 73 20 69 73 20 74 68 65 20 62 6f 78 27 this is the box'
1180: 73 20 66 69 72 73 74 20 70 61 67 65 2c 0a 2e 5c s first page,..\
1190: 22 09 64 72 61 77 20 74 77 6f 20 73 69 64 65 73 ".draw two sides
11a0: 20 62 75 74 20 6e 6f 20 74 6f 70 20 6f 74 68 65 but no top othe
11b0: 72 77 69 73 65 2e 0a 2e 69 65 20 21 5c 5c 6e 28 rwise...ie !\\n(
11c0: 5e 62 2d 31 20 5c 68 27 2d 31 2e 35 6e 27 5c 4c ^b-1 \h'-1.5n'\L
11d0: 27 7c 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c 6c 27 '|\\n(^yu-1v'\l'
11e0: 5c 5c 6e 28 5e 6c 75 2b 33 6e 5c 28 75 6c 27 5c \\n(^lu+3n\(ul'\
11f0: 4c 27 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e L'\\n(^tu+1v-\\n
1200: 28 5e 79 75 27 5c 68 27 7c 30 75 27 5c 63 0a 2e (^yu'\h'|0u'\c..
1210: 65 6c 20 5c 68 27 2d 31 2e 35 6e 27 5c 4c 27 7c el \h'-1.5n'\L'|
1220: 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c 68 27 5c 5c \\n(^yu-1v'\h'\\
1230: 6e 28 5e 6c 75 2b 33 6e 27 5c 4c 27 5c 5c 6e 28 n(^lu+3n'\L'\\n(
1240: 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27 5c ^tu+1v-\\n(^yu'\
1250: 68 27 7c 30 75 27 5c 63 0a 2e 5c 7d 0a 2e 69 66 h'|0u'\c..\}..if
1260: 20 5c 5c 6e 28 5e 76 20 5c 7b 5c 0a 2e 6e 72 20 \\n(^v \{\..nr
1270: 5e 78 20 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c ^x \\n(^tu+1v-\\
1280: 6e 28 5e 59 75 0a 5c 6b 78 5c 68 27 2d 5c 5c 6e n(^Yu.\kx\h'-\\n
1290: 78 75 27 5c 68 27 7c 5c 5c 6e 28 5e 6c 75 2b 33 xu'\h'|\\n(^lu+3
12a0: 6e 27 5c 6b 79 5c 4c 27 2d 5c 5c 6e 28 5e 78 75 n'\ky\L'-\\n(^xu
12b0: 27 5c 76 27 5c 5c 6e 28 5e 78 75 27 5c 68 27 7c '\v'\\n(^xu'\h'|
12c0: 30 75 27 5c 63 0a 2e 5c 7d 0a 2e 62 70 0a 27 66 0u'\c..\}..bp.'f
12d0: 69 0a 2e 65 76 0a 2e 69 66 20 5c 5c 6e 28 5e 62 i..ev..if \\n(^b
12e0: 20 5c 7b 5c 0a 2e 6d 6b 20 5e 79 0a 2e 6e 72 20 \{\..mk ^y..nr
12f0: 5e 62 20 32 0a 2e 5c 7d 0a 2e 69 66 20 5c 5c 6e ^b 2..\}..if \\n
1300: 28 5e 76 20 5c 7b 5c 0a 2e 6d 6b 20 5e 59 0a 2e (^v \{\..mk ^Y..
1310: 5c 7d 0a 2e 2e 0a 2e 5c 22 09 23 20 44 53 20 2d \}.....\".# DS -
1320: 20 62 65 67 69 6e 20 64 69 73 70 6c 61 79 0a 2e begin display..
1330: 64 65 20 44 53 0a 2e 52 53 0a 2e 6e 66 0a 2e 73 de DS..RS..nf..s
1340: 70 0a 2e 2e 0a 2e 5c 22 09 23 20 44 45 20 2d 20 p.....\".# DE -
1350: 65 6e 64 20 64 69 73 70 6c 61 79 0a 2e 64 65 20 end display..de
1360: 44 45 0a 2e 66 69 0a 2e 52 45 0a 2e 73 70 0a 2e DE..fi..RE..sp..
1370: 2e 0a 2e 5c 22 09 23 20 53 4f 20 2d 20 73 74 61 ...\".# SO - sta
1380: 72 74 20 6f 66 20 6c 69 73 74 20 6f 66 20 73 74 rt of list of st
1390: 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 0a 2e andard options..
13a0: 64 65 20 53 4f 0a 27 69 65 20 27 5c 5c 24 31 27 de SO.'ie '\\$1'
13b0: 27 20 2e 64 73 20 53 6f 20 5c 5c 66 42 6f 70 74 ' .ds So \\fBopt
13c0: 69 6f 6e 73 5c 5c 66 52 0a 27 65 6c 20 2e 64 73 ions\\fR.'el .ds
13d0: 20 53 6f 20 5c 5c 66 42 5c 5c 24 31 5c 5c 66 52 So \\fB\\$1\\fR
13e0: 0a 2e 53 48 20 22 53 54 41 4e 44 41 52 44 20 4f ..SH "STANDARD O
13f0: 50 54 49 4f 4e 53 22 0a 2e 4c 50 0a 2e 6e 66 0a PTIONS"..LP..nf.
1400: 2e 74 61 20 35 2e 35 63 20 31 31 63 0a 2e 66 74 .ta 5.5c 11c..ft
1410: 20 42 0a 2e 2e 0a 2e 5c 22 09 23 20 53 45 20 2d B.....\".# SE -
1420: 20 65 6e 64 20 6f 66 20 6c 69 73 74 20 6f 66 20 end of list of
1430: 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 standard options
1440: 0a 2e 64 65 20 53 45 0a 2e 66 69 0a 2e 66 74 20 ..de SE..fi..ft
1450: 52 0a 2e 4c 50 0a 53 65 65 20 74 68 65 20 5c 5c R..LP.See the \\
1460: 2a 28 53 6f 20 6d 61 6e 75 61 6c 20 65 6e 74 72 *(So manual entr
1470: 79 20 66 6f 72 20 64 65 74 61 69 6c 73 20 6f 6e y for details on
1480: 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 6f 70 the standard op
1490: 74 69 6f 6e 73 2e 0a 2e 2e 0a 2e 5c 22 09 23 20 tions......\".#
14a0: 4f 50 20 2d 20 73 74 61 72 74 20 6f 66 20 66 75 OP - start of fu
14b0: 6c 6c 20 64 65 73 63 72 69 70 74 69 6f 6e 20 66 ll description f
14c0: 6f 72 20 61 20 73 69 6e 67 6c 65 20 6f 70 74 69 or a single opti
14d0: 6f 6e 0a 2e 64 65 20 4f 50 0a 2e 4c 50 0a 2e 6e on..de OP..LP..n
14e0: 66 0a 2e 74 61 20 34 63 0a 43 6f 6d 6d 61 6e 64 f..ta 4c.Command
14f0: 2d 4c 69 6e 65 20 4e 61 6d 65 3a 09 5c 5c 66 42 -Line Name:.\\fB
1500: 5c 5c 24 31 5c 5c 66 52 0a 44 61 74 61 62 61 73 \\$1\\fR.Databas
1510: 65 20 4e 61 6d 65 3a 09 5c 5c 66 42 5c 5c 24 32 e Name:.\\fB\\$2
1520: 5c 5c 66 52 0a 44 61 74 61 62 61 73 65 20 43 6c \\fR.Database Cl
1530: 61 73 73 3a 09 5c 5c 66 42 5c 5c 24 33 5c 5c 66 ass:.\\fB\\$3\\f
1540: 52 0a 2e 66 69 0a 2e 49 50 0a 2e 2e 0a 2e 5c 22 R..fi..IP.....\"
1550: 09 23 20 43 53 20 2d 20 62 65 67 69 6e 20 63 6f .# CS - begin co
1560: 64 65 20 65 78 63 65 72 70 74 0a 2e 64 65 20 43 de excerpt..de C
1570: 53 0a 2e 52 53 0a 2e 6e 66 0a 2e 74 61 20 2e 32 S..RS..nf..ta .2
1580: 35 69 20 2e 35 69 20 2e 37 35 69 20 31 69 0a 2e 5i .5i .75i 1i..
1590: 2e 0a 2e 5c 22 09 23 20 43 45 20 2d 20 65 6e 64 ...\".# CE - end
15a0: 20 63 6f 64 65 20 65 78 63 65 72 70 74 0a 2e 64 code excerpt..d
15b0: 65 20 43 45 0a 2e 66 69 0a 2e 52 45 0a 2e 2e 0a e CE..fi..RE....
15c0: 2e 5c 22 09 23 20 55 4c 20 2d 20 75 6e 64 65 72 .\".# UL - under
15d0: 6c 69 6e 65 20 77 6f 72 64 0a 2e 64 65 20 55 4c line word..de UL
15e0: 0a 5c 5c 24 31 5c 6c 27 7c 30 5c 28 75 6c 27 5c .\\$1\l'|0\(ul'\
15f0: 5c 24 32 0a 2e 2e 0a 2e 5c 22 09 23 20 51 57 20 \$2.....\".# QW
1600: 2d 20 61 70 70 6c 79 20 71 75 6f 74 61 74 69 6f - apply quotatio
1610: 6e 20 6d 61 72 6b 73 20 74 6f 20 77 6f 72 64 0a n marks to word.
1620: 2e 64 65 20 51 57 0a 2e 69 65 20 27 5c 5c 2a 28 .de QW..ie '\\*(
1630: 6c 71 27 22 27 20 60 60 5c 5c 24 31 27 27 5c 5c lq'"' ``\\$1''\\
1640: 24 32 0a 2e 5c 22 22 20 66 69 78 20 65 6d 61 63 $2..\"" fix emac
1650: 73 20 68 69 67 68 6c 69 67 68 74 69 6e 67 0a 2e s highlighting..
1660: 65 6c 20 5c 5c 2a 28 6c 71 5c 5c 24 31 5c 5c 2a el \\*(lq\\$1\\*
1670: 28 72 71 5c 5c 24 32 0a 2e 2e 0a 2e 5c 22 09 23 (rq\\$2.....\".#
1680: 20 50 51 20 2d 20 61 70 70 6c 79 20 70 61 72 65 PQ - apply pare
1690: 6e 73 20 61 6e 64 20 71 75 6f 74 61 74 69 6f 6e ns and quotation
16a0: 20 6d 61 72 6b 73 20 74 6f 20 77 6f 72 64 0a 2e marks to word..
16b0: 64 65 20 50 51 0a 2e 69 65 20 27 5c 5c 2a 28 6c de PQ..ie '\\*(l
16c0: 71 27 22 27 20 28 60 60 5c 5c 24 31 27 27 5c 5c q'"' (``\\$1''\\
16d0: 24 32 29 5c 5c 24 33 0a 2e 5c 22 22 20 66 69 78 $2)\\$3..\"" fix
16e0: 20 65 6d 61 63 73 20 68 69 67 68 6c 69 67 68 74 emacs highlight
16f0: 69 6e 67 0a 2e 65 6c 20 28 5c 5c 2a 28 6c 71 5c ing..el (\\*(lq\
1700: 5c 24 31 5c 5c 2a 28 72 71 5c 5c 24 32 29 5c 5c \$1\\*(rq\\$2)\\
1710: 24 33 0a 2e 2e 0a 2e 5c 22 09 23 20 51 52 20 2d $3.....\".# QR -
1720: 20 71 75 6f 74 65 64 20 72 61 6e 67 65 0a 2e 64 quoted range..d
1730: 65 20 51 52 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 e QR..ie '\\*(lq
1740: 27 22 27 20 60 60 5c 5c 24 31 27 27 5c 5c 2d 60 '"' ``\\$1''\\-`
1750: 60 5c 5c 24 32 27 27 5c 5c 24 33 0a 2e 5c 22 22 `\\$2''\\$3..\""
1760: 20 66 69 78 20 65 6d 61 63 73 20 68 69 67 68 6c fix emacs highl
1770: 69 67 68 74 69 6e 67 0a 2e 65 6c 20 5c 5c 2a 28 ighting..el \\*(
1780: 6c 71 5c 5c 24 31 5c 5c 2a 28 72 71 5c 5c 2d 5c lq\\$1\\*(rq\\-\
1790: 5c 2a 28 6c 71 5c 5c 24 32 5c 5c 2a 28 72 71 5c \*(lq\\$2\\*(rq\
17a0: 5c 24 33 0a 2e 2e 0a 2e 5c 22 09 23 20 4d 54 20 \$3.....\".# MT
17b0: 2d 20 22 65 6d 70 74 79 22 20 73 74 72 69 6e 67 - "empty" string
17c0: 0a 2e 64 65 20 4d 54 0a 2e 51 57 20 22 22 0a 2e ..de MT..QW ""..
17d0: 2e 0a 2e 42 53 0a 2e 53 48 20 4e 41 4d 45 0a 63 ...BS..SH NAME.c
17e0: 6d 64 72 3a 3a 76 61 6c 69 64 61 74 65 3a 3a 74 mdr::validate::t
17f0: 69 6d 65 20 5c 2d 20 43 6d 64 72 20 2d 20 56 61 ime \- Cmdr - Va
1800: 6c 69 64 61 74 69 6f 6e 20 74 79 70 65 20 66 6f lidation type fo
1810: 72 20 74 69 6d 65 73 20 28 74 6f 20 74 68 65 20 r times (to the
1820: 73 65 63 6f 6e 64 29 0a 2e 53 48 20 53 59 4e 4f second)..SH SYNO
1830: 50 53 49 53 0a 70 61 63 6b 61 67 65 20 72 65 71 PSIS.package req
1840: 75 69 72 65 20 5c 66 42 74 72 79 20 5c 66 52 0a uire \fBtry \fR.
1850: 2e 73 70 0a 70 61 63 6b 61 67 65 20 72 65 71 75 .sp.package requ
1860: 69 72 65 20 5c 66 42 63 6c 6f 63 6b 3a 3a 69 73 ire \fBclock::is
1870: 6f 38 36 30 31 20 5c 66 52 0a 2e 73 70 0a 70 61 o8601 \fR..sp.pa
1880: 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 5c 66 ckage require \f
1890: 42 63 6d 64 72 3a 3a 76 61 6c 69 64 61 74 65 3a Bcmdr::validate:
18a0: 3a 63 6f 6d 6d 6f 6e 20 5c 66 52 0a 2e 73 70 0a :common \fR..sp.
18b0: 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 package require
18c0: 5c 66 42 63 6d 64 72 3a 3a 76 61 6c 69 64 61 74 \fBcmdr::validat
18d0: 65 3a 3a 74 69 6d 65 20 5c 66 52 0a 2e 73 70 0a e::time \fR..sp.
18e0: 5c 66 42 3a 3a 63 6d 64 72 3a 3a 76 61 6c 69 64 \fB::cmdr::valid
18f0: 61 74 65 3a 3a 74 69 6d 65 5c 66 52 20 5c 66 42 ate::time\fR \fB
1900: 32 65 78 74 65 72 6e 61 6c 5c 66 52 20 5c 66 49 2external\fR \fI
1910: 65 70 6f 63 68 5c 66 52 0a 2e 73 70 0a 2e 42 45 epoch\fR..sp..BE
1920: 0a 2e 53 48 20 44 45 53 43 52 49 50 54 49 4f 4e ..SH DESCRIPTION
1930: 0a 2e 50 50 0a 57 65 6c 63 6f 6d 65 20 74 6f 20 ..PP.Welcome to
1940: 74 68 65 20 43 6d 64 72 20 70 72 6f 6a 65 63 74 the Cmdr project
1950: 2c 20 77 72 69 74 74 65 6e 20 62 79 20 41 6e 64 , written by And
1960: 72 65 61 73 20 4b 75 70 72 69 65 73 5c 26 2e 0a reas Kupries\&..
1970: 2e 50 50 0a 46 6f 72 20 61 76 61 69 6c 61 62 69 .PP.For availabi
1980: 6c 69 74 79 20 70 6c 65 61 73 65 20 72 65 61 64 lity please read
1990: 20 5c 66 49 43 6d 64 72 20 2d 20 48 6f 77 20 54 \fICmdr - How T
19a0: 6f 20 47 65 74 20 54 68 65 20 53 6f 75 72 63 65 o Get The Source
19b0: 73 5c 66 52 5c 26 2e 0a 2e 50 50 0a 2e 50 50 0a s\fR\&...PP..PP.
19c0: 54 68 69 73 20 70 61 63 6b 61 67 65 20 70 72 6f This package pro
19d0: 76 69 64 65 73 20 74 68 65 20 76 61 6c 69 64 61 vides the valida
19e0: 74 69 6f 6e 20 74 79 70 65 0a 5c 66 42 3a 3a 63 tion type.\fB::c
19f0: 6d 64 72 3a 3a 76 61 6c 69 64 61 74 65 3a 3a 74 mdr::validate::t
1a00: 69 6d 65 5c 66 52 20 77 68 69 63 68 20 61 63 63 ime\fR which acc
1a10: 65 70 74 73 20 74 69 6d 65 73 74 61 6d 70 73 20 epts timestamps
1a20: 69 6e 20 62 6f 74 68 20 49 53 4f 20 38 36 30 31 in both ISO 8601
1a30: 0a 73 79 6e 74 61 78 20 61 6e 64 20 61 73 20 65 .syntax and as e
1a40: 70 6f 63 68 20 76 61 6c 75 65 73 2c 20 69 5c 26 poch values, i\&
1a50: 2e 65 5c 26 2e 20 70 6f 73 69 74 69 76 65 20 69 .e\&. positive i
1a60: 6e 74 65 67 65 72 20 73 65 63 6f 6e 64 73 20 73 nteger seconds s
1a70: 69 6e 63 65 20 74 68 65 0a 62 65 67 69 6e 6e 69 ince the.beginni
1a80: 6e 67 20 6f 66 20 75 6e 69 78 20 74 69 6d 65 5c ng of unix time\
1a90: 26 2e 0a 2e 50 50 0a 54 68 65 20 69 6e 74 65 72 &...PP.The inter
1aa0: 6e 61 6c 2c 20 63 61 6e 6f 6e 69 63 61 6c 20 72 nal, canonical r
1ab0: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 69 73 epresentation is
1ac0: 20 74 68 65 20 65 70 6f 63 68 20 66 6f 72 20 74 the epoch for t
1ad0: 68 65 0a 76 61 6c 69 64 61 74 65 64 20 69 6e 70 he.validated inp
1ae0: 75 74 5c 26 2e 0a 2e 50 50 0a 54 68 65 20 74 79 ut\&...PP.The ty
1af0: 70 65 20 68 61 73 20 6e 6f 20 69 6e 70 75 74 20 pe has no input
1b00: 63 6f 6d 70 6c 65 74 69 6f 6e 5c 26 2e 0a 2e 50 completion\&...P
1b10: 50 0a 54 68 65 20 64 65 74 61 69 6c 73 20 6f 66 P.The details of
1b20: 20 74 68 65 20 65 78 70 6f 72 74 65 64 20 73 74 the exported st
1b30: 61 6e 64 61 72 64 20 41 50 49 20 63 61 6e 20 62 andard API can b
1b40: 65 20 66 6f 75 6e 64 20 69 6e 0a 5c 66 49 43 6d e found in.\fICm
1b50: 64 72 20 2d 20 57 72 69 74 69 6e 67 20 63 75 73 dr - Writing cus
1b60: 74 6f 6d 20 76 61 6c 69 64 61 74 69 6f 6e 20 74 tom validation t
1b70: 79 70 65 73 5c 66 52 5c 26 2e 20 54 68 65 20 63 ypes\fR\&. The c
1b80: 68 6f 73 65 6e 20 64 65 66 61 75 6c 74 20 69 73 hosen default is
1b90: 20 22 6e 6f 77 22 5c 26 2e 0a 2e 50 50 0a 41 20 "now"\&...PP.A
1ba0: 73 69 6e 67 6c 65 20 6e 6f 6e 2d 73 74 61 6e 64 single non-stand
1bb0: 61 72 64 20 6d 65 74 68 6f 64 20 69 73 20 70 72 ard method is pr
1bc0: 6f 76 69 64 65 64 3a 0a 2e 54 50 0a 5c 66 42 3a ovided:..TP.\fB:
1bd0: 3a 63 6d 64 72 3a 3a 76 61 6c 69 64 61 74 65 3a :cmdr::validate:
1be0: 3a 74 69 6d 65 5c 66 52 20 5c 66 42 32 65 78 74 :time\fR \fB2ext
1bf0: 65 72 6e 61 6c 5c 66 52 20 5c 66 49 65 70 6f 63 ernal\fR \fIepoc
1c00: 68 5c 66 52 0a 54 68 69 73 20 6d 65 74 68 6f 64 h\fR.This method
1c10: 20 63 6f 6e 76 65 72 74 73 20 74 68 65 20 65 70 converts the ep
1c20: 6f 63 68 20 6f 66 20 61 20 74 69 6d 65 20 74 6f och of a time to
1c30: 20 74 68 65 20 66 6f 72 6d 0a 5c 66 42 25 59 2d the form.\fB%Y-
1c40: 25 6d 2d 25 64 54 25 48 3a 25 4d 3a 25 53 5c 66 %m-%dT%H:%M:%S\f
1c50: 52 20 61 6e 64 20 72 65 74 75 72 6e 73 20 74 68 R and returns th
1c60: 65 20 63 6f 6e 76 65 72 73 69 6f 6e 20 72 65 73 e conversion res
1c70: 75 6c 74 20 61 73 20 69 74 73 20 6f 77 6e 5c 26 ult as its own\&
1c80: 2e 0a 2e 50 50 0a 2e 53 48 20 22 42 55 47 53 2c ...PP..SH "BUGS,
1c90: 20 49 44 45 41 53 2c 20 46 45 45 44 42 41 43 4b IDEAS, FEEDBACK
1ca0: 22 0a 42 6f 74 68 20 74 68 65 20 70 61 63 6b 61 ".Both the packa
1cb0: 67 65 28 73 29 20 61 6e 64 20 74 68 69 73 20 64 ge(s) and this d
1cc0: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 77 69 6c ocumentation wil
1cd0: 6c 20 75 6e 64 6f 75 62 74 65 64 6c 79 20 63 6f l undoubtedly co
1ce0: 6e 74 61 69 6e 0a 62 75 67 73 20 61 6e 64 20 6f ntain.bugs and o
1cf0: 74 68 65 72 20 70 72 6f 62 6c 65 6d 73 5c 26 2e ther problems\&.
1d00: 0a 50 6c 65 61 73 65 20 72 65 70 6f 72 74 20 73 .Please report s
1d10: 75 63 68 20 61 74 0a 5c 66 49 43 6d 64 72 20 54 uch at.\fICmdr T
1d20: 69 63 6b 65 74 73 5c 66 52 20 5b 68 74 74 70 73 ickets\fR [https
1d30: 3a 2f 63 6f 72 65 5c 26 2e 74 63 6c 5c 26 2e 74 :/core\&.tcl\&.t
1d40: 6b 2f 61 6b 75 70 72 69 65 73 2f 63 6d 64 72 5d k/akupries/cmdr]
1d50: 5c 26 2e 0a 2e 50 50 0a 50 6c 65 61 73 65 20 61 \&...PP.Please a
1d60: 6c 73 6f 20 72 65 70 6f 72 74 20 61 6e 79 20 69 lso report any i
1d70: 64 65 61 73 20 79 6f 75 20 6d 61 79 20 68 61 76 deas you may hav
1d80: 65 20 66 6f 72 20 65 6e 68 61 6e 63 65 6d 65 6e e for enhancemen
1d90: 74 73 20 6f 66 0a 65 69 74 68 65 72 20 70 61 63 ts of.either pac
1da0: 6b 61 67 65 28 73 29 20 61 6e 64 2f 6f 72 20 64 kage(s) and/or d
1db0: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 5c 26 2e 0a ocumentation\&..
1dc0: 2e 53 48 20 4b 45 59 57 4f 52 44 53 0a 61 72 67 .SH KEYWORDS.arg
1dd0: 75 6d 65 6e 74 73 2c 20 63 6f 6d 6d 61 6e 64 20 uments, command
1de0: 68 69 65 72 61 72 63 68 79 2c 20 63 6f 6d 6d 61 hierarchy, comma
1df0: 6e 64 20 6c 69 6e 65 20 63 6f 6d 70 6c 65 74 69 nd line completi
1e00: 6f 6e 2c 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 on, command line
1e10: 20 68 61 6e 64 6c 69 6e 67 2c 20 63 6f 6d 6d 61 handling, comma
1e20: 6e 64 20 74 72 65 65 2c 20 65 64 69 74 69 6e 67 nd tree, editing
1e30: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2c 20 68 command line, h
1e40: 65 6c 70 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 20 elp for command
1e50: 6c 69 6e 65 2c 20 68 69 65 72 61 72 63 68 79 20 line, hierarchy
1e60: 6f 66 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 6e 74 of commands, int
1e70: 65 72 61 63 74 69 76 65 20 63 6f 6d 6d 61 6e 64 eractive command
1e80: 20 73 68 65 6c 6c 2c 20 6f 70 74 69 6f 6e 61 6c shell, optional
1e90: 20 61 72 67 75 6d 65 6e 74 73 2c 20 6f 70 74 69 arguments, opti
1ea0: 6f 6e 73 2c 20 70 61 72 61 6d 65 74 65 72 73 2c ons, parameters,
1eb0: 20 70 72 6f 63 65 73 73 69 6e 67 20 63 6f 6d 6d processing comm
1ec0: 61 6e 64 20 6c 69 6e 65 2c 20 74 72 65 65 20 6f and line, tree o
1ed0: 66 20 63 6f 6d 6d 61 6e 64 73 0a 2e 53 48 20 43 f commands..SH C
1ee0: 4f 50 59 52 49 47 48 54 0a 2e 6e 66 0a 43 6f 70 OPYRIGHT..nf.Cop
1ef0: 79 72 69 67 68 74 20 28 63 29 20 32 30 31 33 2d yright (c) 2013-
1f00: 32 30 31 36 20 41 6e 64 72 65 61 73 20 4b 75 70 2016 Andreas Kup
1f10: 72 69 65 73 0a 43 6f 70 79 72 69 67 68 74 20 28 ries.Copyright (
1f20: 63 29 20 32 30 31 33 2d 32 30 31 36 20 44 6f 63 c) 2013-2016 Doc
1f30: 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 41 6e 64 72 umentation, Andr
1f40: 65 61 73 20 4b 75 70 72 69 65 73 0a 0a 2e 66 69 eas Kupries...fi
