cmdr
Hex Artifact Content
Not logged in
Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2019 Conference, Houston/TX, US, Nov 4-8
Send your abstracts to tclconference@googlegroups.com
or submit via the online form by Sep 9.

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