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 [email protected]
or submit via the online form by Sep 9.

Artifact a7649bce3e53edd165d768040f72dd0807e843d4:


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 68 6f 77 74 6f 5f 69 6e 73 74 61 6c 6c 61  r_howto_installa
0030: 74 69 6f 6e 5c 26 2e 6d 61 6e 27 20 62 79 20 74  tion\&.man' by t
0040: 63 6c 6c 69 62 2f 64 6f 63 74 6f 6f 6c 73 20 77  cllib/doctools w
0050: 69 74 68 20 66 6f 72 6d 61 74 20 27 6e 72 6f 66  ith format 'nrof
0060: 66 27 0a 27 5c 22 20 43 6f 70 79 72 69 67 68 74  f'.'\" Copyright
0070: 20 28 63 29 20 32 30 31 33 2d 32 30 31 36 20 41   (c) 2013-2016 A
0080: 6e 64 72 65 61 73 20 4b 75 70 72 69 65 73 0a 27  ndreas Kupries.'
0090: 5c 22 20 43 6f 70 79 72 69 67 68 74 20 28 63 29  \" Copyright (c)
00a0: 20 32 30 31 33 2d 32 30 31 36 20 44 6f 63 75 6d   2013-2016 Docum
00b0: 65 6e 74 61 74 69 6f 6e 2c 20 41 6e 64 72 65 61  entation, Andrea
00c0: 73 20 4b 75 70 72 69 65 73 0a 27 5c 22 0a 2e 54  s Kupries.'\"..T
00d0: 48 20 22 63 6d 64 72 2d 69 6e 73 74 61 6c 6c 61  H "cmdr-installa
00e0: 74 69 6f 6e 22 20 6e 20 31 5c 26 2e 32 20 64 6f  tion" n 1\&.2 do
00f0: 63 20 22 43 6d 64 72 2c 20 61 20 66 72 61 6d 65  c "Cmdr, a frame
0100: 77 6f 72 6b 20 66 6f 72 20 63 6f 6d 6d 61 6e 64  work for command
0110: 20 6c 69 6e 65 20 70 61 72 73 69 6e 67 20 61 6e   line parsing an
0120: 64 20 64 69 73 70 61 74 63 68 22 0a 2e 5c 22 20  d dispatch"..\" 
0130: 54 68 65 20 2d 2a 2d 20 6e 72 6f 66 66 20 2d 2a  The -*- nroff -*
0140: 2d 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 62 65  - definitions be
0150: 6c 6f 77 20 61 72 65 20 66 6f 72 20 73 75 70 70  low are for supp
0160: 6c 65 6d 65 6e 74 61 6c 20 6d 61 63 72 6f 73 20  lemental macros 
0170: 75 73 65 64 0a 2e 5c 22 20 69 6e 20 54 63 6c 2f  used..\" in Tcl/
0180: 54 6b 20 6d 61 6e 75 61 6c 20 65 6e 74 72 69 65  Tk manual entrie
0190: 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 41 50 20 74  s...\"..\" .AP t
01a0: 79 70 65 20 6e 61 6d 65 20 69 6e 2f 6f 75 74 20  ype name in/out 
01b0: 3f 69 6e 64 65 6e 74 3f 0a 2e 5c 22 09 53 74 61  ?indent?..\".Sta
01c0: 72 74 20 70 61 72 61 67 72 61 70 68 20 64 65 73  rt paragraph des
01d0: 63 72 69 62 69 6e 67 20 61 6e 20 61 72 67 75 6d  cribing an argum
01e0: 65 6e 74 20 74 6f 20 61 20 6c 69 62 72 61 72 79  ent to a library
01f0: 20 70 72 6f 63 65 64 75 72 65 2e 0a 2e 5c 22 09   procedure...\".
0200: 74 79 70 65 20 69 73 20 74 79 70 65 20 6f 66 20  type is type of 
0210: 61 72 67 75 6d 65 6e 74 20 28 69 6e 74 2c 20 65  argument (int, e
0220: 74 63 2e 29 2c 20 69 6e 2f 6f 75 74 20 69 73 20  tc.), in/out is 
0230: 65 69 74 68 65 72 20 22 69 6e 22 2c 20 22 6f 75  either "in", "ou
0240: 74 22 2c 0a 2e 5c 22 09 6f 72 20 22 69 6e 2f 6f  t",..\".or "in/o
0250: 75 74 22 20 74 6f 20 64 65 73 63 72 69 62 65 20  ut" to describe 
0260: 77 68 65 74 68 65 72 20 70 72 6f 63 65 64 75 72  whether procedur
0270: 65 20 72 65 61 64 73 20 6f 72 20 6d 6f 64 69 66  e reads or modif
0280: 69 65 73 20 61 72 67 2c 0a 2e 5c 22 09 61 6e 64  ies arg,..\".and
0290: 20 69 6e 64 65 6e 74 20 69 73 20 65 71 75 69 76   indent is equiv
02a0: 61 6c 65 6e 74 20 74 6f 20 73 65 63 6f 6e 64 20  alent to second 
02b0: 61 72 67 20 6f 66 20 2e 49 50 20 28 73 68 6f 75  arg of .IP (shou
02c0: 6c 64 6e 27 74 20 65 76 65 72 20 62 65 0a 2e 5c  ldn't ever be..\
02d0: 22 09 6e 65 65 64 65 64 3b 20 20 75 73 65 20 2e  ".needed;  use .
02e0: 41 53 20 62 65 6c 6f 77 20 69 6e 73 74 65 61 64  AS below instead
02f0: 29 0a 2e 5c 22 0a 2e 5c 22 20 2e 41 53 20 3f 74  )..\"..\" .AS ?t
0300: 79 70 65 3f 20 3f 6e 61 6d 65 3f 0a 2e 5c 22 09  ype? ?name?..\".
0310: 47 69 76 65 20 6d 61 78 69 6d 75 6d 20 73 69 7a  Give maximum siz
0320: 65 73 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20  es of arguments 
0330: 66 6f 72 20 73 65 74 74 69 6e 67 20 74 61 62 20  for setting tab 
0340: 73 74 6f 70 73 2e 20 20 54 79 70 65 20 61 6e 64  stops.  Type and
0350: 0a 2e 5c 22 09 6e 61 6d 65 20 61 72 65 20 65 78  ..\".name are ex
0360: 61 6d 70 6c 65 73 20 6f 66 20 6c 61 72 67 65 73  amples of larges
0370: 74 20 70 6f 73 73 69 62 6c 65 20 61 72 67 75 6d  t possible argum
0380: 65 6e 74 73 20 74 68 61 74 20 77 69 6c 6c 20 62  ents that will b
0390: 65 20 70 61 73 73 65 64 0a 2e 5c 22 09 74 6f 20  e passed..\".to 
03a0: 2e 41 50 20 6c 61 74 65 72 2e 20 20 49 66 20 61  .AP later.  If a
03b0: 72 67 73 20 61 72 65 20 6f 6d 69 74 74 65 64 2c  rgs are omitted,
03c0: 20 64 65 66 61 75 6c 74 20 74 61 62 20 73 74 6f   default tab sto
03d0: 70 73 20 61 72 65 20 75 73 65 64 2e 0a 2e 5c 22  ps are used...\"
03e0: 0a 2e 5c 22 20 2e 42 53 0a 2e 5c 22 09 53 74 61  ..\" .BS..\".Sta
03f0: 72 74 20 62 6f 78 20 65 6e 63 6c 6f 73 75 72 65  rt box enclosure
0400: 2e 20 20 46 72 6f 6d 20 68 65 72 65 20 75 6e 74  .  From here unt
0410: 69 6c 20 6e 65 78 74 20 2e 42 45 2c 20 65 76 65  il next .BE, eve
0420: 72 79 74 68 69 6e 67 20 77 69 6c 6c 20 62 65 0a  rything will be.
0430: 2e 5c 22 09 65 6e 63 6c 6f 73 65 64 20 69 6e 20  .\".enclosed in 
0440: 6f 6e 65 20 6c 61 72 67 65 20 62 6f 78 2e 0a 2e  one large box...
0450: 5c 22 0a 2e 5c 22 20 2e 42 45 0a 2e 5c 22 09 45  \"..\" .BE..\".E
0460: 6e 64 20 6f 66 20 62 6f 78 20 65 6e 63 6c 6f 73  nd of box enclos
0470: 75 72 65 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 43 53  ure...\"..\" .CS
0480: 0a 2e 5c 22 09 42 65 67 69 6e 20 63 6f 64 65 20  ..\".Begin code 
0490: 65 78 63 65 72 70 74 2e 0a 2e 5c 22 0a 2e 5c 22  excerpt...\"..\"
04a0: 20 2e 43 45 0a 2e 5c 22 09 45 6e 64 20 63 6f 64   .CE..\".End cod
04b0: 65 20 65 78 63 65 72 70 74 2e 0a 2e 5c 22 0a 2e  e excerpt...\"..
04c0: 5c 22 20 2e 56 53 20 3f 76 65 72 73 69 6f 6e 3f  \" .VS ?version?
04d0: 20 3f 62 72 3f 0a 2e 5c 22 09 42 65 67 69 6e 20   ?br?..\".Begin 
04e0: 76 65 72 74 69 63 61 6c 20 73 69 64 65 62 61 72  vertical sidebar
04f0: 2c 20 66 6f 72 20 75 73 65 20 69 6e 20 6d 61 72  , for use in mar
0500: 6b 69 6e 67 20 6e 65 77 6c 79 2d 63 68 61 6e 67  king newly-chang
0510: 65 64 20 70 61 72 74 73 0a 2e 5c 22 09 6f 66 20  ed parts..\".of 
0520: 6d 61 6e 20 70 61 67 65 73 2e 20 20 54 68 65 20  man pages.  The 
0530: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69  first argument i
0540: 73 20 69 67 6e 6f 72 65 64 20 61 6e 64 20 75 73  s ignored and us
0550: 65 64 20 66 6f 72 20 72 65 63 6f 72 64 69 6e 67  ed for recording
0560: 0a 2e 5c 22 09 74 68 65 20 76 65 72 73 69 6f 6e  ..\".the version
0570: 20 77 68 65 6e 20 74 68 65 20 2e 56 53 20 77 61   when the .VS wa
0580: 73 20 61 64 64 65 64 2c 20 73 6f 20 74 68 61 74  s added, so that
0590: 20 74 68 65 20 73 69 64 65 62 61 72 73 20 63 61   the sidebars ca
05a0: 6e 20 62 65 0a 2e 5c 22 09 66 6f 75 6e 64 20 61  n be..\".found a
05b0: 6e 64 20 72 65 6d 6f 76 65 64 20 77 68 65 6e 20  nd removed when 
05c0: 74 68 65 79 20 72 65 61 63 68 20 61 20 63 65 72  they reach a cer
05d0: 74 61 69 6e 20 61 67 65 2e 20 20 49 66 20 61 6e  tain age.  If an
05e0: 6f 74 68 65 72 20 61 72 67 75 6d 65 6e 74 0a 2e  other argument..
05f0: 5c 22 09 69 73 20 70 72 65 73 65 6e 74 2c 20 74  \".is present, t
0600: 68 65 6e 20 61 20 6c 69 6e 65 20 62 72 65 61 6b  hen a line break
0610: 20 69 73 20 66 6f 72 63 65 64 20 62 65 66 6f 72   is forced befor
0620: 65 20 73 74 61 72 74 69 6e 67 20 74 68 65 20 73  e starting the s
0630: 69 64 65 62 61 72 2e 0a 2e 5c 22 0a 2e 5c 22 20  idebar...\"..\" 
0640: 2e 56 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 76  .VE..\".End of v
0650: 65 72 74 69 63 61 6c 20 73 69 64 65 62 61 72 2e  ertical sidebar.
0660: 0a 2e 5c 22 0a 2e 5c 22 20 2e 44 53 0a 2e 5c 22  ..\"..\" .DS..\"
0670: 09 42 65 67 69 6e 20 61 6e 20 69 6e 64 65 6e 74  .Begin an indent
0680: 65 64 20 75 6e 66 69 6c 6c 65 64 20 64 69 73 70  ed unfilled disp
0690: 6c 61 79 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 44 45  lay...\"..\" .DE
06a0: 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 69 6e 64 65  ..\".End of inde
06b0: 6e 74 65 64 20 75 6e 66 69 6c 6c 65 64 20 64 69  nted unfilled di
06c0: 73 70 6c 61 79 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e  splay...\"..\" .
06d0: 53 4f 20 3f 6d 61 6e 70 61 67 65 3f 0a 2e 5c 22  SO ?manpage?..\"
06e0: 09 53 74 61 72 74 20 6f 66 20 6c 69 73 74 20 6f  .Start of list o
06f0: 66 20 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f  f standard optio
0700: 6e 73 20 66 6f 72 20 61 20 54 6b 20 77 69 64 67  ns for a Tk widg
0710: 65 74 2e 20 54 68 65 20 6d 61 6e 70 61 67 65 0a  et. The manpage.
0720: 2e 5c 22 09 61 72 67 75 6d 65 6e 74 20 64 65 66  .\".argument def
0730: 69 6e 65 73 20 77 68 65 72 65 20 74 6f 20 6c 6f  ines where to lo
0740: 6f 6b 20 75 70 20 74 68 65 20 73 74 61 6e 64 61  ok up the standa
0750: 72 64 20 6f 70 74 69 6f 6e 73 3b 20 69 66 0a 2e  rd options; if..
0760: 5c 22 09 6f 6d 69 74 74 65 64 2c 20 64 65 66 61  \".omitted, defa
0770: 75 6c 74 73 20 74 6f 20 22 6f 70 74 69 6f 6e 73  ults to "options
0780: 22 2e 20 54 68 65 20 6f 70 74 69 6f 6e 73 20 66  ". The options f
0790: 6f 6c 6c 6f 77 20 6f 6e 20 73 75 63 63 65 73 73  ollow on success
07a0: 69 76 65 0a 2e 5c 22 09 6c 69 6e 65 73 2c 20 69  ive..\".lines, i
07b0: 6e 20 74 68 72 65 65 20 63 6f 6c 75 6d 6e 73 20  n three columns 
07c0: 73 65 70 61 72 61 74 65 64 20 62 79 20 74 61 62  separated by tab
07d0: 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 53 45 0a 2e  s...\"..\" .SE..
07e0: 5c 22 09 45 6e 64 20 6f 66 20 6c 69 73 74 20 6f  \".End of list o
07f0: 66 20 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f  f standard optio
0800: 6e 73 20 66 6f 72 20 61 20 54 6b 20 77 69 64 67  ns for a Tk widg
0810: 65 74 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 4f 50 20  et...\"..\" .OP 
0820: 63 6d 64 4e 61 6d 65 20 64 62 4e 61 6d 65 20 64  cmdName dbName d
0830: 62 43 6c 61 73 73 0a 2e 5c 22 09 53 74 61 72 74  bClass..\".Start
0840: 20 6f 66 20 64 65 73 63 72 69 70 74 69 6f 6e 20   of description 
0850: 6f 66 20 61 20 73 70 65 63 69 66 69 63 20 6f 70  of a specific op
0860: 74 69 6f 6e 2e 20 20 63 6d 64 4e 61 6d 65 20 67  tion.  cmdName g
0870: 69 76 65 73 20 74 68 65 0a 2e 5c 22 09 6f 70 74  ives the..\".opt
0880: 69 6f 6e 27 73 20 6e 61 6d 65 20 61 73 20 73 70  ion's name as sp
0890: 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 63  ecified in the c
08a0: 6c 61 73 73 20 63 6f 6d 6d 61 6e 64 2c 20 64 62  lass command, db
08b0: 4e 61 6d 65 20 67 69 76 65 73 0a 2e 5c 22 09 74  Name gives..\".t
08c0: 68 65 20 6f 70 74 69 6f 6e 27 73 20 6e 61 6d 65  he option's name
08d0: 20 69 6e 20 74 68 65 20 6f 70 74 69 6f 6e 20 64   in the option d
08e0: 61 74 61 62 61 73 65 2c 20 61 6e 64 20 64 62 43  atabase, and dbC
08f0: 6c 61 73 73 20 67 69 76 65 73 0a 2e 5c 22 09 74  lass gives..\".t
0900: 68 65 20 6f 70 74 69 6f 6e 27 73 20 63 6c 61 73  he option's clas
0910: 73 20 69 6e 20 74 68 65 20 6f 70 74 69 6f 6e 20  s in the option 
0920: 64 61 74 61 62 61 73 65 2e 0a 2e 5c 22 0a 2e 5c  database...\"..\
0930: 22 20 2e 55 4c 20 61 72 67 31 20 61 72 67 32 0a  " .UL arg1 arg2.
0940: 2e 5c 22 09 50 72 69 6e 74 20 61 72 67 31 20 75  .\".Print arg1 u
0950: 6e 64 65 72 6c 69 6e 65 64 2c 20 74 68 65 6e 20  nderlined, then 
0960: 70 72 69 6e 74 20 61 72 67 32 20 6e 6f 72 6d 61  print arg2 norma
0970: 6c 6c 79 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 51 57  lly...\"..\" .QW
0980: 20 61 72 67 31 20 3f 61 72 67 32 3f 0a 2e 5c 22   arg1 ?arg2?..\"
0990: 09 50 72 69 6e 74 20 61 72 67 31 20 69 6e 20 71  .Print arg1 in q
09a0: 75 6f 74 65 73 2c 20 74 68 65 6e 20 61 72 67 32  uotes, then arg2
09b0: 20 6e 6f 72 6d 61 6c 6c 79 20 28 66 6f 72 20 74   normally (for t
09c0: 72 61 69 6c 69 6e 67 20 70 75 6e 63 74 75 61 74  railing punctuat
09d0: 69 6f 6e 29 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 50  ion)...\"..\" .P
09e0: 51 20 61 72 67 31 20 3f 61 72 67 32 3f 0a 2e 5c  Q arg1 ?arg2?..\
09f0: 22 09 50 72 69 6e 74 20 61 6e 20 6f 70 65 6e 20  ".Print an open 
0a00: 70 61 72 65 6e 74 68 65 73 69 73 2c 20 61 72 67  parenthesis, arg
0a10: 31 20 69 6e 20 71 75 6f 74 65 73 2c 20 74 68 65  1 in quotes, the
0a20: 6e 20 61 72 67 32 20 6e 6f 72 6d 61 6c 6c 79 0a  n arg2 normally.
0a30: 2e 5c 22 09 28 66 6f 72 20 74 72 61 69 6c 69 6e  .\".(for trailin
0a40: 67 20 70 75 6e 63 74 75 61 74 69 6f 6e 29 20 61  g punctuation) a
0a50: 6e 64 20 74 68 65 6e 20 61 20 63 6c 6f 73 69 6e  nd then a closin
0a60: 67 20 70 61 72 65 6e 74 68 65 73 69 73 2e 0a 2e  g parenthesis...
0a70: 5c 22 0a 2e 5c 22 09 23 20 53 65 74 20 75 70 20  \"..\".# Set up 
0a80: 74 72 61 70 73 20 61 6e 64 20 6f 74 68 65 72 20  traps and other 
0a90: 6d 69 73 63 65 6c 6c 61 6e 65 6f 75 73 20 73 74  miscellaneous st
0aa0: 75 66 66 20 66 6f 72 20 54 63 6c 2f 54 6b 20 6d  uff for Tcl/Tk m
0ab0: 61 6e 20 70 61 67 65 73 2e 0a 2e 69 66 20 74 20  an pages...if t 
0ac0: 2e 77 68 20 2d 31 2e 33 69 20 5e 42 0a 2e 6e 72  .wh -1.3i ^B..nr
0ad0: 20 5e 6c 20 5c 6e 28 2e 6c 0a 2e 61 64 20 62 0a   ^l \n(.l..ad b.
0ae0: 2e 5c 22 09 23 20 53 74 61 72 74 20 61 6e 20 61  .\".# Start an a
0af0: 72 67 75 6d 65 6e 74 20 64 65 73 63 72 69 70 74  rgument descript
0b00: 69 6f 6e 0a 2e 64 65 20 41 50 0a 2e 69 65 20 21  ion..de AP..ie !
0b10: 22 5c 5c 24 34 22 22 20 2e 54 50 20 5c 5c 24 34  "\\$4"" .TP \\$4
0b20: 0a 2e 65 6c 20 5c 7b 5c 0a 2e 20 20 20 69 65 20  ..el \{\..   ie 
0b30: 21 22 5c 5c 24 32 22 22 20 2e 54 50 20 5c 5c 6e  !"\\$2"" .TP \\n
0b40: 28 29 43 75 0a 2e 20 20 20 65 6c 20 20 20 20 20  ()Cu..   el     
0b50: 20 20 20 20 20 2e 54 50 20 31 35 0a 2e 5c 7d 0a       .TP 15..\}.
0b60: 2e 74 61 20 5c 5c 6e 28 29 41 75 20 5c 5c 6e 28  .ta \\n()Au \\n(
0b70: 29 42 75 0a 2e 69 65 20 21 22 5c 5c 24 33 22 22  )Bu..ie !"\\$3""
0b80: 20 5c 7b 5c 0a 5c 26 5c 5c 24 31 20 5c 5c 66 49   \{\.\&\\$1 \\fI
0b90: 5c 5c 24 32 5c 5c 66 50 20 28 5c 5c 24 33 29 0a  \\$2\\fP (\\$3).
0ba0: 2e 5c 22 2e 62 0a 2e 5c 7d 0a 2e 65 6c 20 5c 7b  .\".b..\}..el \{
0bb0: 5c 0a 2e 62 72 0a 2e 69 65 20 21 22 5c 5c 24 32  \..br..ie !"\\$2
0bc0: 22 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 31 09 5c 5c  "" \{\.\&\\$1.\\
0bd0: 66 49 5c 5c 24 32 5c 5c 66 50 0a 2e 5c 7d 0a 2e  fI\\$2\\fP..\}..
0be0: 65 6c 20 5c 7b 5c 0a 5c 26 5c 5c 66 49 5c 5c 24  el \{\.\&\\fI\\$
0bf0: 31 5c 5c 66 50 0a 2e 5c 7d 0a 2e 5c 7d 0a 2e 2e  1\\fP..\}..\}...
0c00: 0a 2e 5c 22 09 23 20 64 65 66 69 6e 65 20 74 61  ..\".# define ta
0c10: 62 62 69 6e 67 20 76 61 6c 75 65 73 20 66 6f 72  bbing values for
0c20: 20 2e 41 50 0a 2e 64 65 20 41 53 0a 2e 6e 72 20   .AP..de AS..nr 
0c30: 29 41 20 31 30 6e 0a 2e 69 66 20 21 22 5c 5c 24  )A 10n..if !"\\$
0c40: 31 22 22 20 2e 6e 72 20 29 41 20 5c 5c 77 27 5c  1"" .nr )A \\w'\
0c50: 5c 24 31 27 75 2b 33 6e 0a 2e 6e 72 20 29 42 20  \$1'u+3n..nr )B 
0c60: 5c 5c 6e 28 29 41 75 2b 31 35 6e 0a 2e 5c 22 0a  \\n()Au+15n..\".
0c70: 2e 69 66 20 21 22 5c 5c 24 32 22 22 20 2e 6e 72  .if !"\\$2"" .nr
0c80: 20 29 42 20 5c 5c 77 27 5c 5c 24 32 27 75 2b 5c   )B \\w'\\$2'u+\
0c90: 5c 6e 28 29 41 75 2b 33 6e 0a 2e 6e 72 20 29 43  \n()Au+3n..nr )C
0ca0: 20 5c 5c 6e 28 29 42 75 2b 5c 5c 77 27 28 69 6e   \\n()Bu+\\w'(in
0cb0: 2f 6f 75 74 29 27 75 2b 32 6e 0a 2e 2e 0a 2e 41  /out)'u+2n.....A
0cc0: 53 20 54 63 6c 5f 49 6e 74 65 72 70 20 54 63 6c  S Tcl_Interp Tcl
0cd0: 5f 43 72 65 61 74 65 49 6e 74 65 72 70 20 69 6e  _CreateInterp in
0ce0: 2f 6f 75 74 0a 2e 5c 22 09 23 20 42 53 20 2d 20  /out..\".# BS - 
0cf0: 73 74 61 72 74 20 62 6f 78 65 64 20 74 65 78 74  start boxed text
0d00: 0a 2e 5c 22 09 23 20 5e 79 20 3d 20 73 74 61 72  ..\".# ^y = star
0d10: 74 69 6e 67 20 79 20 6c 6f 63 61 74 69 6f 6e 0a  ting y location.
0d20: 2e 5c 22 09 23 20 5e 62 20 3d 20 31 0a 2e 64 65  .\".# ^b = 1..de
0d30: 20 42 53 0a 2e 62 72 0a 2e 6d 6b 20 5e 79 0a 2e   BS..br..mk ^y..
0d40: 6e 72 20 5e 62 20 31 75 0a 2e 69 66 20 6e 20 2e  nr ^b 1u..if n .
0d50: 6e 66 0a 2e 69 66 20 6e 20 2e 74 69 20 30 0a 2e  nf..if n .ti 0..
0d60: 69 66 20 6e 20 5c 6c 27 5c 5c 6e 28 2e 6c 75 5c  if n \l'\\n(.lu\
0d70: 28 75 6c 27 0a 2e 69 66 20 6e 20 2e 66 69 0a 2e  (ul'..if n .fi..
0d80: 2e 0a 2e 5c 22 09 23 20 42 45 20 2d 20 65 6e 64  ...\".# BE - end
0d90: 20 62 6f 78 65 64 20 74 65 78 74 20 28 64 72 61   boxed text (dra
0da0: 77 20 62 6f 78 20 6e 6f 77 29 0a 2e 64 65 20 42  w box now)..de B
0db0: 45 0a 2e 6e 66 0a 2e 74 69 20 30 0a 2e 6d 6b 20  E..nf..ti 0..mk 
0dc0: 5e 74 0a 2e 69 65 20 6e 20 5c 6c 27 5c 5c 6e 28  ^t..ie n \l'\\n(
0dd0: 5e 6c 75 5c 28 75 6c 27 0a 2e 65 6c 20 5c 7b 5c  ^lu\(ul'..el \{\
0de0: 0a 2e 5c 22 09 44 72 61 77 20 66 6f 75 72 2d 73  ..\".Draw four-s
0df0: 69 64 65 64 20 62 6f 78 20 6e 6f 72 6d 61 6c 6c  ided box normall
0e00: 79 2c 20 62 75 74 20 64 6f 6e 27 74 20 64 72 61  y, but don't dra
0e10: 77 20 74 6f 70 20 6f 66 0a 2e 5c 22 09 62 6f 78  w top of..\".box
0e20: 20 69 66 20 74 68 65 20 62 6f 78 20 73 74 61 72   if the box star
0e30: 74 65 64 20 6f 6e 20 61 6e 20 65 61 72 6c 69 65  ted on an earlie
0e40: 72 20 70 61 67 65 2e 0a 2e 69 65 20 21 5c 5c 6e  r page...ie !\\n
0e50: 28 5e 62 2d 31 20 5c 7b 5c 0a 5c 68 27 2d 31 2e  (^b-1 \{\.\h'-1.
0e60: 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 79 75 2d 31  5n'\L'|\\n(^yu-1
0e70: 76 27 5c 6c 27 5c 5c 6e 28 5e 6c 75 2b 33 6e 5c  v'\l'\\n(^lu+3n\
0e80: 28 75 6c 27 5c 4c 27 5c 5c 6e 28 5e 74 75 2b 31  (ul'\L'\\n(^tu+1
0e90: 76 2d 5c 5c 6e 28 5e 79 75 27 5c 6c 27 7c 30 75  v-\\n(^yu'\l'|0u
0ea0: 2d 31 2e 35 6e 5c 28 75 6c 27 0a 2e 5c 7d 0a 2e  -1.5n\(ul'..\}..
0eb0: 65 6c 20 5c 7d 5c 0a 5c 68 27 2d 31 2e 35 6e 27  el \}\.\h'-1.5n'
0ec0: 5c 4c 27 7c 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c  \L'|\\n(^yu-1v'\
0ed0: 68 27 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 5c 4c 27  h'\\n(^lu+3n'\L'
0ee0: 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e  \\n(^tu+1v-\\n(^
0ef0: 79 75 27 5c 6c 27 7c 30 75 2d 31 2e 35 6e 5c 28  yu'\l'|0u-1.5n\(
0f00: 75 6c 27 0a 2e 5c 7d 0a 2e 5c 7d 0a 2e 66 69 0a  ul'..\}..\}..fi.
0f10: 2e 62 72 0a 2e 6e 72 20 5e 62 20 30 0a 2e 2e 0a  .br..nr ^b 0....
0f20: 2e 5c 22 09 23 20 56 53 20 2d 20 73 74 61 72 74  .\".# VS - start
0f30: 20 76 65 72 74 69 63 61 6c 20 73 69 64 65 62 61   vertical sideba
0f40: 72 0a 2e 5c 22 09 23 20 5e 59 20 3d 20 73 74 61  r..\".# ^Y = sta
0f50: 72 74 69 6e 67 20 79 20 6c 6f 63 61 74 69 6f 6e  rting y location
0f60: 0a 2e 5c 22 09 23 20 5e 76 20 3d 20 31 20 28 66  ..\".# ^v = 1 (f
0f70: 6f 72 20 74 72 6f 66 66 3b 20 20 66 6f 72 20 6e  or troff;  for n
0f80: 72 6f 66 66 20 74 68 69 73 20 64 6f 65 73 6e 27  roff this doesn'
0f90: 74 20 6d 61 74 74 65 72 29 0a 2e 64 65 20 56 53  t matter)..de VS
0fa0: 0a 2e 69 66 20 21 22 5c 5c 24 32 22 22 20 2e 62  ..if !"\\$2"" .b
0fb0: 72 0a 2e 6d 6b 20 5e 59 0a 2e 69 65 20 6e 20 27  r..mk ^Y..ie n '
0fc0: 6d 63 20 5c 73 31 32 5c 28 62 72 5c 73 30 0a 2e  mc \s12\(br\s0..
0fd0: 65 6c 20 2e 6e 72 20 5e 76 20 31 75 0a 2e 2e 0a  el .nr ^v 1u....
0fe0: 2e 5c 22 09 23 20 56 45 20 2d 20 65 6e 64 20 6f  .\".# VE - end o
0ff0: 66 20 76 65 72 74 69 63 61 6c 20 73 69 64 65 62  f vertical sideb
1000: 61 72 0a 2e 64 65 20 56 45 0a 2e 69 65 20 6e 20  ar..de VE..ie n 
1010: 27 6d 63 0a 2e 65 6c 20 5c 7b 5c 0a 2e 65 76 20  'mc..el \{\..ev 
1020: 32 0a 2e 6e 66 0a 2e 74 69 20 30 0a 2e 6d 6b 20  2..nf..ti 0..mk 
1030: 5e 74 0a 5c 68 27 7c 5c 5c 6e 28 5e 6c 75 2b 33  ^t.\h'|\\n(^lu+3
1040: 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 59 75 2d 31 76  n'\L'|\\n(^Yu-1v
1050: 5c 28 62 76 27 5c 76 27 5c 5c 6e 28 5e 74 75 2b  \(bv'\v'\\n(^tu+
1060: 31 76 2d 5c 5c 6e 28 5e 59 75 27 5c 68 27 2d 7c  1v-\\n(^Yu'\h'-|
1070: 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 0a 2e 73 70 20  \\n(^lu+3n'..sp 
1080: 2d 31 0a 2e 66 69 0a 2e 65 76 0a 2e 5c 7d 0a 2e  -1..fi..ev..\}..
1090: 6e 72 20 5e 76 20 30 0a 2e 2e 0a 2e 5c 22 09 23  nr ^v 0.....\".#
10a0: 20 53 70 65 63 69 61 6c 20 6d 61 63 72 6f 20 74   Special macro t
10b0: 6f 20 68 61 6e 64 6c 65 20 70 61 67 65 20 62 6f  o handle page bo
10c0: 74 74 6f 6d 3a 20 20 66 69 6e 69 73 68 20 6f 66  ttom:  finish of
10d0: 66 20 63 75 72 72 65 6e 74 0a 2e 5c 22 09 23 20  f current..\".# 
10e0: 62 6f 78 2f 73 69 64 65 62 61 72 20 69 66 20 69  box/sidebar if i
10f0: 6e 20 62 6f 78 2f 73 69 64 65 62 61 72 20 6d 6f  n box/sidebar mo
1100: 64 65 2c 20 74 68 65 6e 20 69 6e 76 6f 6b 65 64  de, then invoked
1110: 20 73 74 61 6e 64 61 72 64 0a 2e 5c 22 09 23 20   standard..\".# 
1120: 70 61 67 65 20 62 6f 74 74 6f 6d 20 6d 61 63 72  page bottom macr
1130: 6f 2e 0a 2e 64 65 20 5e 42 0a 2e 65 76 20 32 0a  o...de ^B..ev 2.
1140: 27 74 69 20 30 0a 27 6e 66 0a 2e 6d 6b 20 5e 74  'ti 0.'nf..mk ^t
1150: 0a 2e 69 66 20 5c 5c 6e 28 5e 62 20 5c 7b 5c 0a  ..if \\n(^b \{\.
1160: 2e 5c 22 09 44 72 61 77 20 74 68 72 65 65 2d 73  .\".Draw three-s
1170: 69 64 65 64 20 62 6f 78 20 69 66 20 74 68 69 73  ided box if this
1180: 20 69 73 20 74 68 65 20 62 6f 78 27 73 20 66 69   is the box's fi
1190: 72 73 74 20 70 61 67 65 2c 0a 2e 5c 22 09 64 72  rst page,..\".dr
11a0: 61 77 20 74 77 6f 20 73 69 64 65 73 20 62 75 74  aw two sides but
11b0: 20 6e 6f 20 74 6f 70 20 6f 74 68 65 72 77 69 73   no top otherwis
11c0: 65 2e 0a 2e 69 65 20 21 5c 5c 6e 28 5e 62 2d 31  e...ie !\\n(^b-1
11d0: 20 5c 68 27 2d 31 2e 35 6e 27 5c 4c 27 7c 5c 5c   \h'-1.5n'\L'|\\
11e0: 6e 28 5e 79 75 2d 31 76 27 5c 6c 27 5c 5c 6e 28  n(^yu-1v'\l'\\n(
11f0: 5e 6c 75 2b 33 6e 5c 28 75 6c 27 5c 4c 27 5c 5c  ^lu+3n\(ul'\L'\\
1200: 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75  n(^tu+1v-\\n(^yu
1210: 27 5c 68 27 7c 30 75 27 5c 63 0a 2e 65 6c 20 5c  '\h'|0u'\c..el \
1220: 68 27 2d 31 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28  h'-1.5n'\L'|\\n(
1230: 5e 79 75 2d 31 76 27 5c 68 27 5c 5c 6e 28 5e 6c  ^yu-1v'\h'\\n(^l
1240: 75 2b 33 6e 27 5c 4c 27 5c 5c 6e 28 5e 74 75 2b  u+3n'\L'\\n(^tu+
1250: 31 76 2d 5c 5c 6e 28 5e 79 75 27 5c 68 27 7c 30  1v-\\n(^yu'\h'|0
1260: 75 27 5c 63 0a 2e 5c 7d 0a 2e 69 66 20 5c 5c 6e  u'\c..\}..if \\n
1270: 28 5e 76 20 5c 7b 5c 0a 2e 6e 72 20 5e 78 20 5c  (^v \{\..nr ^x \
1280: 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 59  \n(^tu+1v-\\n(^Y
1290: 75 0a 5c 6b 78 5c 68 27 2d 5c 5c 6e 78 75 27 5c  u.\kx\h'-\\nxu'\
12a0: 68 27 7c 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 5c 6b  h'|\\n(^lu+3n'\k
12b0: 79 5c 4c 27 2d 5c 5c 6e 28 5e 78 75 27 5c 76 27  y\L'-\\n(^xu'\v'
12c0: 5c 5c 6e 28 5e 78 75 27 5c 68 27 7c 30 75 27 5c  \\n(^xu'\h'|0u'\
12d0: 63 0a 2e 5c 7d 0a 2e 62 70 0a 27 66 69 0a 2e 65  c..\}..bp.'fi..e
12e0: 76 0a 2e 69 66 20 5c 5c 6e 28 5e 62 20 5c 7b 5c  v..if \\n(^b \{\
12f0: 0a 2e 6d 6b 20 5e 79 0a 2e 6e 72 20 5e 62 20 32  ..mk ^y..nr ^b 2
1300: 0a 2e 5c 7d 0a 2e 69 66 20 5c 5c 6e 28 5e 76 20  ..\}..if \\n(^v 
1310: 5c 7b 5c 0a 2e 6d 6b 20 5e 59 0a 2e 5c 7d 0a 2e  \{\..mk ^Y..\}..
1320: 2e 0a 2e 5c 22 09 23 20 44 53 20 2d 20 62 65 67  ...\".# DS - beg
1330: 69 6e 20 64 69 73 70 6c 61 79 0a 2e 64 65 20 44  in display..de D
1340: 53 0a 2e 52 53 0a 2e 6e 66 0a 2e 73 70 0a 2e 2e  S..RS..nf..sp...
1350: 0a 2e 5c 22 09 23 20 44 45 20 2d 20 65 6e 64 20  ..\".# DE - end 
1360: 64 69 73 70 6c 61 79 0a 2e 64 65 20 44 45 0a 2e  display..de DE..
1370: 66 69 0a 2e 52 45 0a 2e 73 70 0a 2e 2e 0a 2e 5c  fi..RE..sp.....\
1380: 22 09 23 20 53 4f 20 2d 20 73 74 61 72 74 20 6f  ".# SO - start o
1390: 66 20 6c 69 73 74 20 6f 66 20 73 74 61 6e 64 61  f list of standa
13a0: 72 64 20 6f 70 74 69 6f 6e 73 0a 2e 64 65 20 53  rd options..de S
13b0: 4f 0a 27 69 65 20 27 5c 5c 24 31 27 27 20 2e 64  O.'ie '\\$1'' .d
13c0: 73 20 53 6f 20 5c 5c 66 42 6f 70 74 69 6f 6e 73  s So \\fBoptions
13d0: 5c 5c 66 52 0a 27 65 6c 20 2e 64 73 20 53 6f 20  \\fR.'el .ds So 
13e0: 5c 5c 66 42 5c 5c 24 31 5c 5c 66 52 0a 2e 53 48  \\fB\\$1\\fR..SH
13f0: 20 22 53 54 41 4e 44 41 52 44 20 4f 50 54 49 4f   "STANDARD OPTIO
1400: 4e 53 22 0a 2e 4c 50 0a 2e 6e 66 0a 2e 74 61 20  NS"..LP..nf..ta 
1410: 35 2e 35 63 20 31 31 63 0a 2e 66 74 20 42 0a 2e  5.5c 11c..ft B..
1420: 2e 0a 2e 5c 22 09 23 20 53 45 20 2d 20 65 6e 64  ...\".# SE - end
1430: 20 6f 66 20 6c 69 73 74 20 6f 66 20 73 74 61 6e   of list of stan
1440: 64 61 72 64 20 6f 70 74 69 6f 6e 73 0a 2e 64 65  dard options..de
1450: 20 53 45 0a 2e 66 69 0a 2e 66 74 20 52 0a 2e 4c   SE..fi..ft R..L
1460: 50 0a 53 65 65 20 74 68 65 20 5c 5c 2a 28 53 6f  P.See the \\*(So
1470: 20 6d 61 6e 75 61 6c 20 65 6e 74 72 79 20 66 6f   manual entry fo
1480: 72 20 64 65 74 61 69 6c 73 20 6f 6e 20 74 68 65  r details on the
1490: 20 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e   standard option
14a0: 73 2e 0a 2e 2e 0a 2e 5c 22 09 23 20 4f 50 20 2d  s......\".# OP -
14b0: 20 73 74 61 72 74 20 6f 66 20 66 75 6c 6c 20 64   start of full d
14c0: 65 73 63 72 69 70 74 69 6f 6e 20 66 6f 72 20 61  escription for a
14d0: 20 73 69 6e 67 6c 65 20 6f 70 74 69 6f 6e 0a 2e   single option..
14e0: 64 65 20 4f 50 0a 2e 4c 50 0a 2e 6e 66 0a 2e 74  de OP..LP..nf..t
14f0: 61 20 34 63 0a 43 6f 6d 6d 61 6e 64 2d 4c 69 6e  a 4c.Command-Lin
1500: 65 20 4e 61 6d 65 3a 09 5c 5c 66 42 5c 5c 24 31  e Name:.\\fB\\$1
1510: 5c 5c 66 52 0a 44 61 74 61 62 61 73 65 20 4e 61  \\fR.Database Na
1520: 6d 65 3a 09 5c 5c 66 42 5c 5c 24 32 5c 5c 66 52  me:.\\fB\\$2\\fR
1530: 0a 44 61 74 61 62 61 73 65 20 43 6c 61 73 73 3a  .Database Class:
1540: 09 5c 5c 66 42 5c 5c 24 33 5c 5c 66 52 0a 2e 66  .\\fB\\$3\\fR..f
1550: 69 0a 2e 49 50 0a 2e 2e 0a 2e 5c 22 09 23 20 43  i..IP.....\".# C
1560: 53 20 2d 20 62 65 67 69 6e 20 63 6f 64 65 20 65  S - begin code e
1570: 78 63 65 72 70 74 0a 2e 64 65 20 43 53 0a 2e 52  xcerpt..de CS..R
1580: 53 0a 2e 6e 66 0a 2e 74 61 20 2e 32 35 69 20 2e  S..nf..ta .25i .
1590: 35 69 20 2e 37 35 69 20 31 69 0a 2e 2e 0a 2e 5c  5i .75i 1i.....\
15a0: 22 09 23 20 43 45 20 2d 20 65 6e 64 20 63 6f 64  ".# CE - end cod
15b0: 65 20 65 78 63 65 72 70 74 0a 2e 64 65 20 43 45  e excerpt..de CE
15c0: 0a 2e 66 69 0a 2e 52 45 0a 2e 2e 0a 2e 5c 22 09  ..fi..RE.....\".
15d0: 23 20 55 4c 20 2d 20 75 6e 64 65 72 6c 69 6e 65  # UL - underline
15e0: 20 77 6f 72 64 0a 2e 64 65 20 55 4c 0a 5c 5c 24   word..de UL.\\$
15f0: 31 5c 6c 27 7c 30 5c 28 75 6c 27 5c 5c 24 32 0a  1\l'|0\(ul'\\$2.
1600: 2e 2e 0a 2e 5c 22 09 23 20 51 57 20 2d 20 61 70  ....\".# QW - ap
1610: 70 6c 79 20 71 75 6f 74 61 74 69 6f 6e 20 6d 61  ply quotation ma
1620: 72 6b 73 20 74 6f 20 77 6f 72 64 0a 2e 64 65 20  rks to word..de 
1630: 51 57 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 27 22  QW..ie '\\*(lq'"
1640: 27 20 60 60 5c 5c 24 31 27 27 5c 5c 24 32 0a 2e  ' ``\\$1''\\$2..
1650: 5c 22 22 20 66 69 78 20 65 6d 61 63 73 20 68 69  \"" fix emacs hi
1660: 67 68 6c 69 67 68 74 69 6e 67 0a 2e 65 6c 20 5c  ghlighting..el \
1670: 5c 2a 28 6c 71 5c 5c 24 31 5c 5c 2a 28 72 71 5c  \*(lq\\$1\\*(rq\
1680: 5c 24 32 0a 2e 2e 0a 2e 5c 22 09 23 20 50 51 20  \$2.....\".# PQ 
1690: 2d 20 61 70 70 6c 79 20 70 61 72 65 6e 73 20 61  - apply parens a
16a0: 6e 64 20 71 75 6f 74 61 74 69 6f 6e 20 6d 61 72  nd quotation mar
16b0: 6b 73 20 74 6f 20 77 6f 72 64 0a 2e 64 65 20 50  ks to word..de P
16c0: 51 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 27 22 27  Q..ie '\\*(lq'"'
16d0: 20 28 60 60 5c 5c 24 31 27 27 5c 5c 24 32 29 5c   (``\\$1''\\$2)\
16e0: 5c 24 33 0a 2e 5c 22 22 20 66 69 78 20 65 6d 61  \$3..\"" fix ema
16f0: 63 73 20 68 69 67 68 6c 69 67 68 74 69 6e 67 0a  cs highlighting.
1700: 2e 65 6c 20 28 5c 5c 2a 28 6c 71 5c 5c 24 31 5c  .el (\\*(lq\\$1\
1710: 5c 2a 28 72 71 5c 5c 24 32 29 5c 5c 24 33 0a 2e  \*(rq\\$2)\\$3..
1720: 2e 0a 2e 5c 22 09 23 20 51 52 20 2d 20 71 75 6f  ...\".# QR - quo
1730: 74 65 64 20 72 61 6e 67 65 0a 2e 64 65 20 51 52  ted range..de QR
1740: 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 27 22 27 20  ..ie '\\*(lq'"' 
1750: 60 60 5c 5c 24 31 27 27 5c 5c 2d 60 60 5c 5c 24  ``\\$1''\\-``\\$
1760: 32 27 27 5c 5c 24 33 0a 2e 5c 22 22 20 66 69 78  2''\\$3..\"" fix
1770: 20 65 6d 61 63 73 20 68 69 67 68 6c 69 67 68 74   emacs highlight
1780: 69 6e 67 0a 2e 65 6c 20 5c 5c 2a 28 6c 71 5c 5c  ing..el \\*(lq\\
1790: 24 31 5c 5c 2a 28 72 71 5c 5c 2d 5c 5c 2a 28 6c  $1\\*(rq\\-\\*(l
17a0: 71 5c 5c 24 32 5c 5c 2a 28 72 71 5c 5c 24 33 0a  q\\$2\\*(rq\\$3.
17b0: 2e 2e 0a 2e 5c 22 09 23 20 4d 54 20 2d 20 22 65  ....\".# MT - "e
17c0: 6d 70 74 79 22 20 73 74 72 69 6e 67 0a 2e 64 65  mpty" string..de
17d0: 20 4d 54 0a 2e 51 57 20 22 22 0a 2e 2e 0a 2e 42   MT..QW "".....B
17e0: 53 0a 2e 53 48 20 4e 41 4d 45 0a 63 6d 64 72 2d  S..SH NAME.cmdr-
17f0: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 5c 2d 20  installation \- 
1800: 43 6d 64 72 20 2d 20 54 68 65 20 49 6e 73 74 61  Cmdr - The Insta
1810: 6c 6c 65 72 27 73 20 47 75 69 64 65 0a 2e 53 48  ller's Guide..SH
1820: 20 44 45 53 43 52 49 50 54 49 4f 4e 0a 2e 50 50   DESCRIPTION..PP
1830: 0a 57 65 6c 63 6f 6d 65 20 74 6f 20 74 68 65 20  .Welcome to the 
1840: 43 6d 64 72 20 70 72 6f 6a 65 63 74 2c 20 77 72  Cmdr project, wr
1850: 69 74 74 65 6e 20 62 79 20 41 6e 64 72 65 61 73  itten by Andreas
1860: 20 4b 75 70 72 69 65 73 5c 26 2e 0a 2e 50 50 0a   Kupries\&...PP.
1870: 46 6f 72 20 61 76 61 69 6c 61 62 69 6c 69 74 79  For availability
1880: 20 70 6c 65 61 73 65 20 72 65 61 64 20 5c 66 49   please read \fI
1890: 43 6d 64 72 20 2d 20 48 6f 77 20 54 6f 20 47 65  Cmdr - How To Ge
18a0: 74 20 54 68 65 20 53 6f 75 72 63 65 73 5c 66 52  t The Sources\fR
18b0: 5c 26 2e 0a 2e 50 50 0a 2e 50 50 0a 54 68 65 20  \&...PP..PP.The 
18c0: 61 75 64 69 65 6e 63 65 20 6f 66 20 74 68 69 73  audience of this
18d0: 20 64 6f 63 75 6d 65 6e 74 20 61 72 65 20 61 6e   document are an
18e0: 79 6f 6e 65 20 77 69 73 68 69 6e 67 20 74 6f 20  yone wishing to 
18f0: 62 75 69 6c 64 20 74 68 65 0a 43 6d 64 72 20 70  build the.Cmdr p
1900: 72 6f 6a 65 63 74 2c 20 66 6f 72 20 65 69 74 68  roject, for eith
1910: 65 72 20 74 68 65 6d 73 65 6c 76 65 73 2c 20 6f  er themselves, o
1920: 72 20 6f 74 68 65 72 73 5c 26 2e 0a 2e 50 50 0a  r others\&...PP.
1930: 49 66 20 79 6f 75 20 61 72 65 20 61 20 64 65 76  If you are a dev
1940: 65 6c 6f 70 65 72 20 69 6e 74 65 6e 64 69 6e 67  eloper intending
1950: 20 74 6f 20 65 78 74 65 6e 64 20 6f 72 20 6d 6f   to extend or mo
1960: 64 69 66 79 20 74 68 65 20 70 72 6f 6a 65 63 74  dify the project
1970: 0a 70 6c 65 61 73 65 20 73 65 65 20 74 68 65 20  .please see the 
1980: 6c 69 73 74 20 6f 66 20 5c 66 42 52 65 6c 61 74  list of \fBRelat
1990: 65 64 20 44 6f 63 75 6d 65 6e 74 73 5c 66 52 20  ed Documents\fR 
19a0: 66 6f 72 20 72 65 66 65 72 65 6e 63 65 73 20 74  for references t
19b0: 6f 0a 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69  o.more informati
19c0: 6f 6e 20 6f 6e 20 74 68 69 73 20 74 6f 70 69 63  on on this topic
19d0: 5c 26 2e 0a 2e 50 50 0a 50 6c 65 61 73 65 20 72  \&...PP.Please r
19e0: 65 61 64 20 5c 66 49 43 6d 64 72 20 2d 20 48 6f  ead \fICmdr - Ho
19f0: 77 20 54 6f 20 47 65 74 20 54 68 65 20 53 6f 75  w To Get The Sou
1a00: 72 63 65 73 5c 66 52 20 66 69 72 73 74 2c 20 69  rces\fR first, i
1a10: 66 20 74 68 61 74 20 77 61 73 20 6e 6f 74 20 64  f that was not d
1a20: 6f 6e 65 0a 61 6c 72 65 61 64 79 5c 26 2e 20 48  one.already\&. H
1a30: 65 72 65 20 77 65 20 61 73 73 75 6d 65 20 74 68  ere we assume th
1a40: 61 74 20 74 68 65 20 73 6f 75 72 63 65 73 20 61  at the sources a
1a50: 72 65 20 61 6c 72 65 61 64 79 20 61 76 61 69 6c  re already avail
1a60: 61 62 6c 65 20 69 6e 20 61 0a 64 69 72 65 63 74  able in a.direct
1a70: 6f 72 79 20 6f 66 20 79 6f 75 72 20 63 68 6f 69  ory of your choi
1a80: 63 65 5c 26 2e 0a 2e 50 50 0a 2e 53 48 20 52 45  ce\&...PP..SH RE
1a90: 51 55 49 53 49 54 45 53 0a 2e 53 53 20 54 43 4c  QUISITES..SS TCL
1aa0: 0a 54 68 69 73 20 70 72 6f 6a 65 63 74 20 72 65  .This project re
1ab0: 71 75 69 72 65 73 20 61 20 77 6f 72 6b 69 6e 67  quires a working
1ac0: 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 6f 66   installation of
1ad0: 20 54 63 6c 20 38 5c 26 2e 35 2c 20 6f 72 20 68   Tcl 8\&.5, or h
1ae0: 69 67 68 65 72 5c 26 2e 0a 2e 50 50 0a 55 73 65  igher\&...PP.Use
1af0: 20 77 68 61 74 65 76 65 72 20 79 6f 75 20 61 72   whatever you ar
1b00: 65 20 63 6f 6d 66 6f 72 74 61 62 6c 65 20 77 69  e comfortable wi
1b10: 74 68 2c 20 61 73 20 6c 6f 6e 67 20 61 73 20 69  th, as long as i
1b20: 74 20 70 72 6f 76 69 64 65 73 0a 54 63 6c 20 38  t provides.Tcl 8
1b30: 5c 26 2e 35 2c 20 6f 72 20 68 69 67 68 65 72 5c  \&.5, or higher\
1b40: 26 2e 0a 2e 50 50 0a 41 6e 20 65 61 73 79 20 77  &...PP.An easy w
1b50: 61 79 20 74 6f 20 67 65 74 20 61 20 70 72 6f 70  ay to get a prop
1b60: 65 72 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20  er installation 
1b70: 6f 66 20 61 20 72 65 63 65 6e 74 20 54 63 6c 20  of a recent Tcl 
1b80: 38 5c 26 2e 35 2c 0a 28 77 68 69 63 68 20 49 20  8\&.5,.(which I 
1b90: 72 65 63 6f 6d 6d 65 6e 64 29 20 69 73 20 74 6f  recommend) is to
1ba0: 20 64 6f 77 6e 6c 6f 61 64 20 61 6e 64 20 69 6e   download and in
1bb0: 73 74 61 6c 6c 0a 5c 66 49 41 63 74 69 76 65 53  stall.\fIActiveS
1bc0: 74 61 74 65 27 73 5c 66 52 20 5b 68 74 74 70 3a  tate's\fR [http:
1bd0: 2f 2f 77 77 77 5c 26 2e 61 63 74 69 76 65 73 74  //www\&.activest
1be0: 61 74 65 5c 26 2e 63 6f 6d 5d 0a 5c 66 49 41 63  ate\&.com].\fIAc
1bf0: 74 69 76 65 54 63 6c 20 38 5c 26 2e 35 5c 66 52  tiveTcl 8\&.5\fR
1c00: 20 5b 68 74 74 70 3a 2f 2f 77 77 77 5c 26 2e 61   [http://www\&.a
1c10: 63 74 69 76 65 73 74 61 74 65 5c 26 2e 63 6f 6d  ctivestate\&.com
1c20: 2f 61 63 74 69 76 65 74 63 6c 5d 0a 66 6f 72 20  /activetcl].for 
1c30: 79 6f 75 72 20 70 6c 61 74 66 6f 72 6d 5c 26 2e  your platform\&.
1c40: 20 4a 75 73 74 20 66 6f 6c 6c 6f 77 20 74 68 65   Just follow the
1c50: 20 6c 69 6e 6b 20 61 6e 64 20 69 6e 73 74 72 75   link and instru
1c60: 63 74 69 6f 6e 20 6f 6e 20 74 68 61 74 20 73 69  ction on that si
1c70: 74 65 5c 26 2e 0a 2e 50 50 0a 41 66 74 65 72 20  te\&...PP.After 
1c80: 74 68 65 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e  the installation
1c90: 20 6f 66 20 41 63 74 69 76 65 54 63 6c 20 38 5c   of ActiveTcl 8\
1ca0: 26 2e 35 20 73 69 6d 70 6c 79 20 72 75 6e 20 74  &.5 simply run t
1cb0: 68 65 20 63 6f 6d 6d 61 6e 64 0a 2e 43 53 0a 0a  he command..CS..
1cc0: 0a 20 20 20 20 74 65 61 63 75 70 20 75 70 64 61  .    teacup upda
1cd0: 74 65 0a 0a 2e 43 45 0a 54 68 69 73 20 77 69 6c  te...CE.This wil
1ce0: 6c 20 69 6e 73 74 61 6c 6c 20 61 20 6c 6f 74 20  l install a lot 
1cf0: 6d 6f 72 65 20 70 61 63 6b 61 67 65 73 20 74 68  more packages th
1d00: 61 6e 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20  an found in the 
1d10: 64 69 73 74 72 69 62 75 74 69 6f 6e 0a 61 6c 6f  distribution.alo
1d20: 6e 65 5c 26 2e 0a 28 44 69 73 63 6c 6f 73 75 72  ne\&..(Disclosur
1d30: 65 3a 20 49 2c 20 41 6e 64 72 65 61 73 20 4b 75  e: I, Andreas Ku
1d40: 70 72 69 65 73 2c 20 77 6f 72 6b 20 66 6f 72 20  pries, work for 
1d50: 41 63 74 69 76 65 53 74 61 74 65 2c 20 6d 61 69  ActiveState, mai
1d60: 6e 74 61 69 6e 69 6e 67 0a 41 63 74 69 76 65 54  ntaining.ActiveT
1d70: 63 6c 20 61 6e 64 20 54 63 6c 44 65 76 4b 69 74  cl and TclDevKit
1d80: 29 5c 26 2e 0a 2e 50 50 0a 44 6f 20 79 6f 75 20  )\&...PP.Do you 
1d90: 77 69 73 68 20 74 6f 20 62 75 69 6c 64 20 54 63  wish to build Tc
1da0: 6c 20 6f 6e 20 79 6f 75 72 20 6f 77 6e 20 3f 0a  l on your own ?.
1db0: 54 68 65 20 73 6f 75 72 63 65 73 20 6f 66 20 61  The sources of a
1dc0: 6c 6c 20 76 65 72 73 69 6f 6e 73 20 63 61 6e 20  ll versions can 
1dd0: 62 65 20 66 6f 75 6e 64 20 61 74 0a 2e 54 50 0a  be found at..TP.
1de0: 54 63 6c 0a 5c 66 49 68 74 74 70 3a 2f 2f 63 6f  Tcl.\fIhttp://co
1df0: 72 65 5c 26 2e 74 63 6c 5c 26 2e 74 6b 2f 74 63  re\&.tcl\&.tk/tc
1e00: 6c 2f 5c 66 52 0a 2e 50 50 0a 2e 53 53 20 54 43  l/\fR..PP..SS TC
1e10: 4c 4f 4f 0a 54 68 65 20 66 72 61 6d 65 77 6f 72  LOO.The framewor
1e20: 6b 20 75 73 65 73 20 74 68 65 20 5c 66 42 54 63  k uses the \fBTc
1e30: 6c 4f 4f 5c 66 52 20 70 61 63 6b 61 67 65 20 69  lOO\fR package i
1e40: 6e 20 69 74 73 20 69 6d 70 6c 65 6d 65 6e 74 61  n its implementa
1e50: 74 69 6f 6e 5c 26 2e 0a 54 68 69 73 20 70 61 63  tion\&..This pac
1e60: 6b 61 67 65 20 72 65 71 75 69 72 65 73 20 54 63  kage requires Tc
1e70: 6c 20 38 5c 26 2e 35 20 6f 72 20 68 69 67 68 65  l 8\&.5 or highe
1e80: 72 5c 26 2e 0a 2e 50 50 0a 49 6e 20 54 63 6c 20  r\&...PP.In Tcl 
1e90: 38 5c 26 2e 36 20 74 68 65 20 70 61 63 6b 61 67  8\&.6 the packag
1ea0: 65 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 65  e is part of the
1eb0: 20 63 6f 72 65 20 69 74 73 65 6c 66 2c 20 77 69   core itself, wi
1ec0: 74 68 6f 75 74 0a 72 65 71 75 69 72 69 6e 67 20  thout.requiring 
1ed0: 61 20 73 65 70 61 72 61 74 65 20 69 6e 73 74 61  a separate insta
1ee0: 6c 6c 61 74 69 6f 6e 5c 26 2e 0a 2e 50 50 0a 46  llation\&...PP.F
1ef0: 6f 72 20 54 63 6c 20 38 5c 26 2e 35 20 69 74 20  or Tcl 8\&.5 it 
1f00: 68 61 73 20 74 6f 20 62 65 20 69 6e 73 74 61 6c  has to be instal
1f10: 6c 65 64 20 73 65 70 61 72 61 74 65 6c 79 5c 26  led separately\&
1f20: 2e 0a 2e 50 50 0a 4f 75 74 20 6f 66 20 74 68 65  ...PP.Out of the
1f30: 20 6d 61 6e 79 20 70 6f 73 73 69 62 69 6c 69 74   many possibilit
1f40: 65 73 20 66 6f 72 20 67 65 74 74 69 6e 67 20 54  es for getting T
1f50: 63 6c 4f 4f 20 28 4f 53 20 76 65 6e 64 6f 72 2c  clOO (OS vendor,
1f60: 0a 6f 73 2d 69 6e 64 65 70 65 6e 64 65 6e 74 20  .os-independent 
1f70: 76 65 6e 64 6f 72 2c 20 62 75 69 6c 64 69 6e 67  vendor, building
1f80: 20 66 72 6f 6d 20 73 6f 75 72 63 65 73 29 20 75   from sources) u
1f90: 73 65 20 77 68 61 74 65 76 65 72 20 79 6f 75 20  se whatever you 
1fa0: 61 72 65 0a 63 6f 6d 66 6f 72 74 61 62 6c 65 20  are.comfortable 
1fb0: 77 69 74 68 5c 26 2e 0a 2e 50 50 0a 46 6f 72 20  with\&...PP.For 
1fc0: 6d 79 73 65 6c 66 2c 20 49 20 61 6d 20 6d 6f 73  myself, I am mos
1fd0: 74 20 63 6f 6d 66 6f 72 74 61 62 6c 65 20 77 69  t comfortable wi
1fe0: 74 68 20 75 73 69 6e 67 0a 5c 66 49 41 63 74 69  th using.\fIActi
1ff0: 76 65 53 74 61 74 65 27 73 5c 66 52 20 5b 68 74  veState's\fR [ht
2000: 74 70 3a 2f 2f 77 77 77 5c 26 2e 61 63 74 69 76  tp://www\&.activ
2010: 65 73 74 61 74 65 5c 26 2e 63 6f 6d 5d 0a 41 63  estate\&.com].Ac
2020: 74 69 76 65 54 63 6c 20 64 69 73 74 72 69 62 75  tiveTcl distribu
2030: 74 69 6f 6e 20 61 6e 64 20 54 45 41 70 6f 74 5c  tion and TEApot\
2040: 26 2e 0a 2e 50 50 0a 53 65 65 20 74 68 65 20 70  &...PP.See the p
2050: 72 65 76 69 6f 75 73 20 73 65 63 74 69 6f 6e 20  revious section 
2060: 28 5c 66 42 54 63 6c 5c 66 52 29 20 66 6f 72 20  (\fBTcl\fR) for 
2070: 64 69 73 63 6c 6f 73 75 72 65 20 61 6e 64 0a 69  disclosure and.i
2080: 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 68 6f  nformation on ho
2090: 77 20 74 6f 20 67 65 74 20 69 74 5c 26 2e 0a 2e  w to get it\&...
20a0: 50 50 0a 41 73 73 75 6d 69 6e 67 20 74 68 61 74  PP.Assuming that
20b0: 20 41 63 74 69 76 65 54 63 6c 20 67 6f 74 20 69   ActiveTcl got i
20c0: 6e 73 74 61 6c 6c 65 64 20 72 75 6e 6e 69 6e 67  nstalled running
20d0: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 0a 2e 43 53   the command..CS
20e0: 0a 0a 0a 20 20 20 20 74 65 61 63 75 70 20 69 6e  ...    teacup in
20f0: 73 74 61 6c 6c 20 54 63 6c 4f 4f 0a 0a 2e 43 45  stall TclOO...CE
2100: 0a 77 69 6c 6c 20 69 6e 73 74 61 6c 6c 20 74 68  .will install th
2110: 65 20 70 61 63 6b 61 67 65 20 66 6f 72 20 79 6f  e package for yo
2120: 75 72 20 70 6c 61 74 66 6f 72 6d 2c 20 69 66 20  ur platform, if 
2130: 79 6f 75 20 68 61 76 65 20 6e 6f 74 20 64 6f 6e  you have not don
2140: 65 20 74 68 65 0a 6d 6f 72 65 20 69 6e 63 6c 75  e the.more inclu
2150: 73 69 76 65 0a 2e 43 53 0a 0a 0a 20 20 20 20 74  sive..CS...    t
2160: 65 61 63 75 70 20 75 70 64 61 74 65 0a 0a 2e 43  eacup update...C
2170: 45 0a 74 6f 20 67 65 74 20 65 76 65 72 79 74 68  E.to get everyth
2180: 69 6e 67 20 61 6e 64 20 74 68 65 20 6b 69 74 63  ing and the kitc
2190: 68 65 6e 73 69 6e 6b 5c 26 2e 0a 2e 50 50 0a 46  hensink\&...PP.F
21a0: 6f 72 20 74 68 6f 73 65 20 77 69 73 68 69 6e 67  or those wishing
21b0: 20 74 6f 20 62 75 69 6c 64 20 61 6e 64 20 69 6e   to build and in
21c0: 73 74 61 6c 6c 20 54 63 6c 4f 4f 20 6f 6e 20 74  stall TclOO on t
21d0: 68 65 69 72 20 6f 77 6e 2c 20 74 68 65 0a 72 65  heir own, the.re
21e0: 6c 65 76 61 6e 74 20 73 6f 75 72 63 65 73 20 63  levant sources c
21f0: 61 6e 20 62 65 20 66 6f 75 6e 64 20 61 74 20 5c  an be found at \
2200: 66 49 68 74 74 70 3a 2f 2f 63 6f 72 65 5c 26 2e  fIhttp://core\&.
2210: 74 63 6c 5c 26 2e 74 6b 2f 74 63 6c 6f 6f 5c 66  tcl\&.tk/tcloo\f
2220: 52 0a 74 6f 67 65 74 68 65 72 20 77 69 74 68 20  R.together with 
2230: 74 68 65 20 6e 65 63 65 73 73 61 72 79 20 69 6e  the necessary in
2240: 73 74 72 75 63 74 69 6f 6e 73 20 6f 6e 20 68 6f  structions on ho
2250: 77 20 74 6f 20 62 75 69 6c 64 20 69 74 5c 26 2e  w to build it\&.
2260: 0a 2e 50 50 0a 49 66 20 74 68 65 72 65 20 61 72  ..PP.If there ar
2270: 65 20 70 72 6f 62 6c 65 6d 73 20 77 69 74 68 20  e problems with 
2280: 62 75 69 6c 64 69 6e 67 2c 20 69 6e 73 74 61 6c  building, instal
2290: 6c 69 6e 67 2c 20 6f 72 20 75 73 69 6e 67 20 54  ling, or using T
22a0: 63 6c 4f 4f 0a 61 6e 64 20 69 74 73 20 70 61 63  clOO.and its pac
22b0: 6b 61 67 65 73 20 70 6c 65 61 73 65 20 66 69 6c  kages please fil
22c0: 65 20 61 20 62 75 67 20 61 67 61 69 6e 73 74 20  e a bug against 
22d0: 54 63 6c 4f 4f 2c 20 6f 72 20 74 68 65 20 76 65  TclOO, or the ve
22e0: 6e 64 6f 72 20 6f 66 0a 79 6f 75 72 20 64 69 73  ndor of.your dis
22f0: 74 72 69 62 75 74 69 6f 6e 2c 20 61 6e 64 20 6e  tribution, and n
2300: 6f 74 20 5c 66 42 63 6d 64 72 5c 66 52 5c 26 2e  ot \fBcmdr\fR\&.
2310: 0a 2e 53 53 20 54 43 4c 4c 49 42 0a 54 68 65 20  ..SS TCLLIB.The 
2320: 66 72 61 6d 65 77 6f 72 6b 20 72 65 71 75 69 72  framework requir
2330: 65 73 20 74 65 6e 20 70 61 63 6b 61 67 65 73 20  es ten packages 
2340: 66 6f 75 6e 64 20 69 6e 20 54 63 6c 6c 69 62 5c  found in Tcllib\
2350: 26 2e 0a 54 68 65 73 65 20 61 72 65 0a 2e 49 50  &..These are..IP
2360: 20 5b 31 5d 0a 5c 66 42 64 65 62 75 67 5c 66 52   [1].\fBdebug\fR
2370: 0a 2e 49 50 20 5b 32 5d 0a 5c 66 42 64 65 62 75  ..IP [2].\fBdebu
2380: 67 3a 3a 63 61 6c 6c 65 72 5c 66 52 0a 2e 49 50  g::caller\fR..IP
2390: 20 5b 33 5d 0a 5c 66 42 6a 73 6f 6e 3a 3a 77 72   [3].\fBjson::wr
23a0: 69 74 65 5c 66 52 0a 2e 49 50 20 5b 34 5d 0a 5c  ite\fR..IP [4].\
23b0: 66 42 6c 61 6d 62 64 61 5c 66 52 0a 2e 49 50 20  fBlambda\fR..IP 
23c0: 5b 35 5d 0a 5c 66 42 6f 6f 3a 3a 75 74 69 6c 5c  [5].\fBoo::util\
23d0: 66 52 0a 2e 49 50 20 5b 36 5d 0a 5c 66 42 73 74  fR..IP [6].\fBst
23e0: 72 69 6e 67 3a 3a 74 6f 6b 65 6e 3a 3a 73 68 65  ring::token::she
23f0: 6c 6c 5c 66 52 0a 2e 49 50 20 5b 37 5d 0a 5c 66  ll\fR..IP [7].\f
2400: 42 73 74 72 75 63 74 3a 3a 71 75 65 75 65 5c 66  Bstruct::queue\f
2410: 52 0a 2e 49 50 20 5b 38 5d 0a 5c 66 42 74 65 72  R..IP [8].\fBter
2420: 6d 3a 3a 61 6e 73 69 3a 3a 63 6f 64 65 3a 3a 63  m::ansi::code::c
2430: 74 72 6c 5c 66 52 0a 2e 49 50 20 5b 39 5d 0a 5c  trl\fR..IP [9].\
2440: 66 42 74 65 78 74 75 74 69 6c 3a 3a 61 64 6a 75  fBtextutil::adju
2450: 73 74 5c 66 52 0a 2e 49 50 20 5b 31 30 5d 0a 5c  st\fR..IP [10].\
2460: 66 42 74 72 79 5c 66 52 0a 2e 50 50 0a 2e 50 50  fBtry\fR..PP..PP
2470: 0a 4f 75 74 20 6f 66 20 74 68 65 20 6d 61 6e 79  .Out of the many
2480: 20 70 6f 73 73 69 62 69 6c 69 74 65 73 20 66 6f   possibilites fo
2490: 72 20 67 65 74 74 69 6e 67 20 54 63 6c 6c 69 62  r getting Tcllib
24a0: 20 28 4f 53 20 76 65 6e 64 6f 72 2c 0a 6f 73 2d   (OS vendor,.os-
24b0: 69 6e 64 65 70 65 6e 64 65 6e 74 20 76 65 6e 64  independent vend
24c0: 6f 72 2c 20 62 75 69 6c 64 69 6e 67 20 66 72 6f  or, building fro
24d0: 6d 20 73 6f 75 72 63 65 73 29 20 75 73 65 20 77  m sources) use w
24e0: 68 61 74 65 76 65 72 20 79 6f 75 20 61 72 65 0a  hatever you are.
24f0: 63 6f 6d 66 6f 72 74 61 62 6c 65 20 77 69 74 68  comfortable with
2500: 5c 26 2e 0a 2e 50 50 0a 46 6f 72 20 6d 79 73 65  \&...PP.For myse
2510: 6c 66 2c 20 49 20 61 6d 20 6d 6f 73 74 20 63 6f  lf, I am most co
2520: 6d 66 6f 72 74 61 62 6c 65 20 77 69 74 68 20 75  mfortable with u
2530: 73 69 6e 67 0a 5c 66 49 41 63 74 69 76 65 53 74  sing.\fIActiveSt
2540: 61 74 65 27 73 5c 66 52 20 5b 68 74 74 70 3a 2f  ate's\fR [http:/
2550: 2f 77 77 77 5c 26 2e 61 63 74 69 76 65 73 74 61  /www\&.activesta
2560: 74 65 5c 26 2e 63 6f 6d 5d 0a 41 63 74 69 76 65  te\&.com].Active
2570: 54 63 6c 20 64 69 73 74 72 69 62 75 74 69 6f 6e  Tcl distribution
2580: 20 61 6e 64 20 54 45 41 70 6f 74 5c 26 2e 0a 2e   and TEApot\&...
2590: 50 50 0a 53 65 65 20 74 68 65 20 70 72 65 76 69  PP.See the previ
25a0: 6f 75 73 20 73 65 63 74 69 6f 6e 20 28 5c 66 42  ous section (\fB
25b0: 54 63 6c 5c 66 52 29 20 66 6f 72 20 64 69 73 63  Tcl\fR) for disc
25c0: 6c 6f 73 75 72 65 20 61 6e 64 0a 69 6e 66 6f 72  losure and.infor
25d0: 6d 61 74 69 6f 6e 20 6f 6e 20 68 6f 77 20 74 6f  mation on how to
25e0: 20 67 65 74 20 69 74 5c 26 2e 0a 2e 50 50 0a 41   get it\&...PP.A
25f0: 73 73 75 6d 69 6e 67 20 74 68 61 74 20 41 63 74  ssuming that Act
2600: 69 76 65 54 63 6c 20 67 6f 74 20 69 6e 73 74 61  iveTcl got insta
2610: 6c 6c 65 64 20 72 75 6e 6e 69 6e 67 20 74 68 65  lled running the
2620: 20 63 6f 6d 6d 61 6e 64 73 0a 2e 43 53 0a 0a 0a   commands..CS...
2630: 20 20 20 20 74 65 61 63 75 70 20 69 6e 73 74 61      teacup insta
2640: 6c 6c 20 64 65 62 75 67 0a 20 20 20 20 74 65 61  ll debug.    tea
2650: 63 75 70 20 69 6e 73 74 61 6c 6c 20 64 65 62 75  cup install debu
2660: 67 3a 3a 63 61 6c 6c 65 72 0a 20 20 20 20 74 65  g::caller.    te
2670: 61 63 75 70 20 69 6e 73 74 61 6c 6c 20 6a 73 6f  acup install jso
2680: 6e 3a 3a 77 72 69 74 65 0a 20 20 20 20 74 65 61  n::write.    tea
2690: 63 75 70 20 69 6e 73 74 61 6c 6c 20 6c 61 6d 62  cup install lamb
26a0: 64 61 0a 20 20 20 20 74 65 61 63 75 70 20 69 6e  da.    teacup in
26b0: 73 74 61 6c 6c 20 6f 6f 3a 3a 75 74 69 6c 0a 20  stall oo::util. 
26c0: 20 20 20 74 65 61 63 75 70 20 69 6e 73 74 61 6c     teacup instal
26d0: 6c 20 73 74 72 69 6e 67 3a 3a 74 6f 6b 65 6e 3a  l string::token:
26e0: 3a 73 68 65 6c 6c 0a 20 20 20 20 74 65 61 63 75  :shell.    teacu
26f0: 70 20 69 6e 73 74 61 6c 6c 20 73 74 72 75 63 74  p install struct
2700: 3a 3a 71 75 65 75 65 0a 20 20 20 20 74 65 61 63  ::queue.    teac
2710: 75 70 20 69 6e 73 74 61 6c 6c 20 74 65 72 6d 3a  up install term:
2720: 3a 61 6e 73 69 3a 3a 63 6f 64 65 3a 3a 63 74 72  :ansi::code::ctr
2730: 6c 0a 20 20 20 20 74 65 61 63 75 70 20 69 6e 73  l.    teacup ins
2740: 74 61 6c 6c 20 74 65 78 74 75 74 69 6c 3a 3a 61  tall textutil::a
2750: 64 6a 75 73 74 0a 20 20 20 20 74 65 61 63 75 70  djust.    teacup
2760: 20 69 6e 73 74 61 6c 6c 20 74 72 79 0a 0a 2e 43   install try...C
2770: 45 0a 77 69 6c 6c 20 69 6e 73 74 61 6c 6c 20 74  E.will install t
2780: 68 65 6d 20 66 6f 72 20 79 6f 75 72 20 70 6c 61  hem for your pla
2790: 74 66 6f 72 6d 2c 20 69 66 20 79 6f 75 20 68 61  tform, if you ha
27a0: 76 65 20 6e 6f 74 20 64 6f 6e 65 20 74 68 65 20  ve not done the 
27b0: 6d 6f 72 65 0a 69 6e 63 6c 75 73 69 76 65 0a 2e  more.inclusive..
27c0: 43 53 0a 0a 0a 20 20 20 20 74 65 61 63 75 70 20  CS...    teacup 
27d0: 75 70 64 61 74 65 0a 0a 2e 43 45 0a 74 6f 20 67  update...CE.to g
27e0: 65 74 20 65 76 65 72 79 74 68 69 6e 67 20 61 6e  et everything an
27f0: 64 20 74 68 65 20 6b 69 74 63 68 65 6e 73 69 6e  d the kitchensin
2800: 6b 5c 26 2e 0a 2e 50 50 0a 46 6f 72 20 74 68 6f  k\&...PP.For tho
2810: 73 65 20 77 69 73 68 69 6e 67 20 74 6f 20 62 75  se wishing to bu
2820: 69 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 20  ild and install 
2830: 54 63 6c 6c 69 62 20 6f 6e 20 74 68 65 69 72 20  Tcllib on their 
2840: 6f 77 6e 2c 20 74 68 65 0a 72 65 6c 65 76 61 6e  own, the.relevan
2850: 74 20 73 6f 75 72 63 65 73 20 63 61 6e 20 62 65  t sources can be
2860: 20 66 6f 75 6e 64 20 61 74 20 5c 66 49 68 74 74   found at \fIhtt
2870: 70 3a 2f 2f 63 6f 72 65 5c 26 2e 74 63 6c 5c 26  p://core\&.tcl\&
2880: 2e 74 6b 2f 74 63 6c 6c 69 62 5c 66 52 0a 74 6f  .tk/tcllib\fR.to
2890: 67 65 74 68 65 72 20 77 69 74 68 20 74 68 65 20  gether with the 
28a0: 6e 65 63 65 73 73 61 72 79 20 69 6e 73 74 72 75  necessary instru
28b0: 63 74 69 6f 6e 73 20 6f 6e 20 68 6f 77 20 74 6f  ctions on how to
28c0: 20 62 75 69 6c 64 20 69 74 5c 26 2e 0a 2e 50 50   build it\&...PP
28d0: 0a 49 66 20 74 68 65 72 65 20 61 72 65 20 70 72  .If there are pr
28e0: 6f 62 6c 65 6d 73 20 77 69 74 68 20 62 75 69 6c  oblems with buil
28f0: 64 69 6e 67 2c 20 69 6e 73 74 61 6c 6c 69 6e 67  ding, installing
2900: 2c 20 6f 72 20 75 73 69 6e 67 0a 54 63 6c 6c 69  , or using.Tclli
2910: 62 20 61 6e 64 20 69 74 73 20 70 61 63 6b 61 67  b and its packag
2920: 65 73 20 70 6c 65 61 73 65 20 66 69 6c 65 20 61  es please file a
2930: 20 62 75 67 20 61 67 61 69 6e 73 74 20 54 63 6c   bug against Tcl
2940: 6c 69 62 2c 20 6f 72 20 74 68 65 0a 76 65 6e 64  lib, or the.vend
2950: 6f 72 20 6f 66 20 79 6f 75 72 20 64 69 73 74 72  or of your distr
2960: 69 62 75 74 69 6f 6e 2c 20 61 6e 64 20 6e 6f 74  ibution, and not
2970: 20 5c 66 42 63 6d 64 72 5c 66 52 5c 26 2e 0a 2e   \fBcmdr\fR\&...
2980: 53 53 20 4c 49 4e 45 4e 4f 49 53 45 0a 54 68 65  SS LINENOISE.The
2990: 20 66 72 61 6d 65 77 6f 72 6b 20 75 73 65 73 20   framework uses 
29a0: 74 68 65 20 5c 66 42 6c 69 6e 65 6e 6f 69 73 65  the \fBlinenoise
29b0: 5c 66 52 20 70 61 63 6b 61 67 65 20 69 6e 20 69  \fR package in i
29c0: 74 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  ts implementatio
29d0: 6e 5c 26 2e 0a 54 68 69 73 20 70 61 63 6b 61 67  n\&..This packag
29e0: 65 20 72 65 71 75 69 72 65 73 20 54 63 6c 20 38  e requires Tcl 8
29f0: 5c 26 2e 35 20 6f 72 20 68 69 67 68 65 72 5c 26  \&.5 or higher\&
2a00: 2e 0a 2e 50 50 0a 4f 75 74 20 6f 66 20 74 68 65  ...PP.Out of the
2a10: 20 6d 61 6e 79 20 70 6f 73 73 69 62 69 6c 69 74   many possibilit
2a20: 65 73 20 66 6f 72 20 67 65 74 74 69 6e 67 20 4c  es for getting L
2a30: 69 6e 65 6e 6f 69 73 65 20 28 4f 53 20 76 65 6e  inenoise (OS ven
2a40: 64 6f 72 2c 0a 6f 73 2d 69 6e 64 65 70 65 6e 64  dor,.os-independ
2a50: 65 6e 74 20 76 65 6e 64 6f 72 2c 20 62 75 69 6c  ent vendor, buil
2a60: 64 69 6e 67 20 66 72 6f 6d 20 73 6f 75 72 63 65  ding from source
2a70: 73 29 20 75 73 65 20 77 68 61 74 65 76 65 72 20  s) use whatever 
2a80: 79 6f 75 20 61 72 65 0a 63 6f 6d 66 6f 72 74 61  you are.comforta
2a90: 62 6c 65 20 77 69 74 68 5c 26 2e 0a 2e 50 50 0a  ble with\&...PP.
2aa0: 46 6f 72 20 6d 79 73 65 6c 66 2c 20 49 20 61 6d  For myself, I am
2ab0: 20 6d 6f 73 74 20 63 6f 6d 66 6f 72 74 61 62 6c   most comfortabl
2ac0: 65 20 77 69 74 68 20 75 73 69 6e 67 0a 5c 66 49  e with using.\fI
2ad0: 41 63 74 69 76 65 53 74 61 74 65 27 73 5c 66 52  ActiveState's\fR
2ae0: 20 5b 68 74 74 70 3a 2f 2f 77 77 77 5c 26 2e 61   [http://www\&.a
2af0: 63 74 69 76 65 73 74 61 74 65 5c 26 2e 63 6f 6d  ctivestate\&.com
2b00: 5d 0a 41 63 74 69 76 65 54 63 6c 20 64 69 73 74  ].ActiveTcl dist
2b10: 72 69 62 75 74 69 6f 6e 20 61 6e 64 20 54 45 41  ribution and TEA
2b20: 70 6f 74 5c 26 2e 0a 2e 50 50 0a 53 65 65 20 74  pot\&...PP.See t
2b30: 68 65 20 70 72 65 76 69 6f 75 73 20 73 65 63 74  he previous sect
2b40: 69 6f 6e 20 28 5c 66 42 54 63 6c 5c 66 52 29 20  ion (\fBTcl\fR) 
2b50: 66 6f 72 20 64 69 73 63 6c 6f 73 75 72 65 20 61  for disclosure a
2b60: 6e 64 0a 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f  nd.information o
2b70: 6e 20 68 6f 77 20 74 6f 20 67 65 74 20 69 74 5c  n how to get it\
2b80: 26 2e 0a 2e 50 50 0a 41 73 73 75 6d 69 6e 67 20  &...PP.Assuming 
2b90: 74 68 61 74 20 41 63 74 69 76 65 54 63 6c 20 67  that ActiveTcl g
2ba0: 6f 74 20 69 6e 73 74 61 6c 6c 65 64 20 72 75 6e  ot installed run
2bb0: 6e 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e 64  ning the command
2bc0: 0a 2e 43 53 0a 0a 0a 20 20 20 20 74 65 61 63 75  ..CS...    teacu
2bd0: 70 20 69 6e 73 74 61 6c 6c 20 6c 69 6e 65 6e 6f  p install lineno
2be0: 69 73 65 0a 0a 2e 43 45 0a 77 69 6c 6c 20 69 6e  ise...CE.will in
2bf0: 73 74 61 6c 6c 20 74 68 65 20 70 61 63 6b 61 67  stall the packag
2c00: 65 20 66 6f 72 20 79 6f 75 72 20 70 6c 61 74 66  e for your platf
2c10: 6f 72 6d 2c 20 69 66 20 79 6f 75 20 68 61 76 65  orm, if you have
2c20: 20 6e 6f 74 20 64 6f 6e 65 20 74 68 65 0a 6d 6f   not done the.mo
2c30: 72 65 20 69 6e 63 6c 75 73 69 76 65 0a 2e 43 53  re inclusive..CS
2c40: 0a 0a 0a 20 20 20 20 74 65 61 63 75 70 20 75 70  ...    teacup up
2c50: 64 61 74 65 0a 0a 2e 43 45 0a 74 6f 20 67 65 74  date...CE.to get
2c60: 20 65 76 65 72 79 74 68 69 6e 67 20 61 6e 64 20   everything and 
2c70: 74 68 65 20 6b 69 74 63 68 65 6e 73 69 6e 6b 5c  the kitchensink\
2c80: 26 2e 0a 2e 50 50 0a 46 6f 72 20 74 68 6f 73 65  &...PP.For those
2c90: 20 77 69 73 68 69 6e 67 20 74 6f 20 62 75 69 6c   wishing to buil
2ca0: 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 20 4c 69  d and install Li
2cb0: 6e 65 6e 6f 69 73 65 20 6f 6e 20 74 68 65 69 72  nenoise on their
2cc0: 20 6f 77 6e 2c 0a 74 68 65 20 72 65 6c 65 76 61   own,.the releva
2cd0: 6e 74 20 73 6f 75 72 63 65 73 20 63 61 6e 20 62  nt sources can b
2ce0: 65 20 66 6f 75 6e 64 20 61 74 0a 5c 66 49 68 74  e found at.\fIht
2cf0: 74 70 3a 2f 2f 67 69 74 68 75 62 5c 26 2e 63 6f  tp://github\&.co
2d00: 6d 2f 61 6e 64 72 65 61 73 2d 6b 75 70 72 69 65  m/andreas-kuprie
2d10: 73 2f 74 63 6c 2d 6c 69 6e 65 6e 6f 69 73 65 5c  s/tcl-linenoise\
2d20: 66 52 20 74 6f 67 65 74 68 65 72 20 77 69 74 68  fR together with
2d30: 0a 74 68 65 20 6e 65 63 65 73 73 61 72 79 20 69  .the necessary i
2d40: 6e 73 74 72 75 63 74 69 6f 6e 73 20 6f 6e 20 68  nstructions on h
2d50: 6f 77 20 74 6f 20 62 75 69 6c 64 20 69 74 5c 26  ow to build it\&
2d60: 2e 0a 2e 50 50 0a 49 66 20 74 68 65 72 65 20 61  ...PP.If there a
2d70: 72 65 20 70 72 6f 62 6c 65 6d 73 20 77 69 74 68  re problems with
2d80: 20 62 75 69 6c 64 69 6e 67 2c 20 69 6e 73 74 61   building, insta
2d90: 6c 6c 69 6e 67 2c 20 6f 72 20 75 73 69 6e 67 0a  lling, or using.
2da0: 6c 69 6e 65 6e 6f 69 73 65 20 70 6c 65 61 73 65  linenoise please
2db0: 20 66 69 6c 65 20 61 20 62 75 67 20 61 67 61 69   file a bug agai
2dc0: 6e 73 74 20 4c 69 6e 65 6e 6f 69 73 65 2c 20 6f  nst Linenoise, o
2dd0: 72 20 74 68 65 20 76 65 6e 64 6f 72 0a 6f 66 20  r the vendor.of 
2de0: 79 6f 75 72 20 64 69 73 74 72 69 62 75 74 69 6f  your distributio
2df0: 6e 2c 20 61 6e 64 20 6e 6f 74 20 5c 66 42 63 6d  n, and not \fBcm
2e00: 64 72 5c 66 52 5c 26 2e 0a 2e 53 53 20 4b 45 54  dr\fR\&...SS KET
2e10: 54 4c 45 0a 54 68 69 73 20 70 72 6f 6a 65 63 74  TLE.This project
2e20: 20 75 73 65 73 20 74 68 65 20 4b 65 74 74 6c 65   uses the Kettle
2e30: 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 61 6e 64   application and
2e40: 20 70 61 63 6b 61 67 65 20 61 73 20 69 74 73 20   package as its 
2e50: 62 75 69 6c 64 20 73 79 73 74 65 6d 5c 26 2e 0a  build system\&..
2e60: 2e 50 50 0a 50 6c 65 61 73 65 20 67 6f 20 74 6f  .PP.Please go to
2e70: 20 65 69 74 68 65 72 20 74 68 65 20 6d 61 69 6e   either the main
2e80: 20 72 65 70 6f 73 69 74 6f 72 79 20 61 74 0a 5c   repository at.\
2e90: 66 49 68 74 74 70 3a 2f 2f 63 6f 72 65 5c 26 2e  fIhttp://core\&.
2ea0: 74 63 6c 5c 26 2e 74 6b 2f 61 6b 75 70 72 69 65  tcl\&.tk/akuprie
2eb0: 73 2f 6b 65 74 74 6c 65 5c 66 52 0a 6f 72 20 74  s/kettle\fR.or t
2ec0: 68 65 20 62 61 63 6b 75 70 20 61 74 0a 5c 66 49  he backup at.\fI
2ed0: 68 74 74 70 3a 2f 2f 63 68 69 73 65 6c 61 70 70  http://chiselapp
2ee0: 5c 26 2e 63 6f 6d 2f 61 6e 64 72 65 61 73 5f 6b  \&.com/andreas_k
2ef0: 75 70 72 69 65 73 2f 72 65 70 6f 73 69 74 6f 72  upries/repositor
2f00: 69 65 73 2f 4b 65 74 74 6c 65 5c 66 52 0a 61 6e  ies/Kettle\fR.an
2f10: 64 20 66 6f 6c 6c 6f 77 20 74 68 65 20 69 6e 73  d follow the ins
2f20: 74 72 75 63 74 69 6f 6e 73 20 67 69 76 65 6e 20  tructions given 
2f30: 61 74 20 74 68 65 73 65 20 73 69 74 65 73 20 74  at these sites t
2f40: 6f 20 63 72 65 61 74 65 20 61 20 77 6f 72 6b 69  o create a worki
2f50: 6e 67 0a 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 5c  ng.installation\
2f60: 26 2e 20 54 68 65 79 20 61 72 65 20 6e 6f 74 20  &. They are not 
2f70: 72 65 70 65 61 74 65 64 20 68 65 72 65 5c 26 2e  repeated here\&.
2f80: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 70 72   If there are pr
2f90: 6f 62 6c 65 6d 73 20 77 69 74 68 0a 74 68 65 73  oblems with.thes
2fa0: 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 70  e instructions p
2fb0: 6c 65 61 73 65 20 66 69 6c 65 20 61 20 62 75 67  lease file a bug
2fc0: 20 61 67 61 69 6e 73 74 20 74 68 65 20 4b 65 74   against the Ket
2fd0: 74 6c 65 20 70 72 6f 6a 65 63 74 2c 20 61 6e 64  tle project, and
2fe0: 0a 6e 6f 74 20 5c 66 42 43 6d 64 72 5c 66 52 5c  .not \fBCmdr\fR\
2ff0: 26 2e 0a 2e 50 50 0a 2e 53 48 20 22 42 55 49 4c  &...PP..SH "BUIL
3000: 44 20 26 20 49 4e 53 54 41 4c 4c 41 54 49 4f 4e  D & INSTALLATION
3010: 22 0a 43 6d 64 72 20 75 73 65 73 20 74 68 65 20  ".Cmdr uses the 
3020: 4b 65 74 74 6c 65 20 61 70 70 6c 69 63 61 74 69  Kettle applicati
3030: 6f 6e 20 61 6e 64 20 70 61 63 6b 61 67 65 20 74  on and package t
3040: 6f 20 68 61 6e 64 6c 65 20 62 75 69 6c 64 69 6e  o handle buildin
3050: 67 0a 61 6e 64 20 69 6e 73 74 61 6c 6c 61 74 69  g.and installati
3060: 6f 6e 5c 26 2e 20 49 74 20 69 73 20 61 73 73 75  on\&. It is assu
3070: 6d 65 64 20 74 6f 20 62 65 20 69 6e 73 74 61 6c  med to be instal
3080: 6c 65 64 20 61 6e 64 20 77 6f 72 6b 69 6e 67 5c  led and working\
3090: 26 2e 20 50 6c 65 61 73 65 20 73 65 65 0a 73 65  &. Please see.se
30a0: 63 74 69 6f 6e 20 5c 66 42 4b 65 74 74 6c 65 5c  ction \fBKettle\
30b0: 66 52 20 69 6e 20 5c 66 42 52 65 71 75 69 73 69  fR in \fBRequisi
30c0: 74 65 73 5c 66 52 20 66 6f 72 20 6d 6f 72 65 20  tes\fR for more 
30d0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 5c 26 2e 0a 2e  information\&...
30e0: 50 50 0a 4e 6f 74 65 20 74 68 61 74 20 61 6c 6c  PP.Note that all
30f0: 20 61 63 63 65 73 73 20 74 6f 20 4b 65 74 74 6c   access to Kettl
3100: 65 20 69 73 20 6d 65 64 69 61 74 65 64 20 62 79  e is mediated by
3110: 20 74 68 65 20 22 5c 66 49 62 75 69 6c 64 5c 26   the "\fIbuild\&
3120: 2e 74 63 6c 5c 66 52 22 0a 73 63 72 69 70 74 2c  .tcl\fR".script,
3130: 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 74 6f   found in the to
3140: 70 2d 6c 65 76 65 6c 20 64 69 72 65 63 74 6f 72  p-level director
3150: 79 20 6f 66 20 74 68 65 20 70 72 6f 6a 65 63 74  y of the project
3160: 5c 26 2e 0a 2e 50 50 0a 46 6f 72 20 74 68 65 20  \&...PP.For the 
3170: 6d 6f 73 74 20 62 61 73 69 63 20 69 6e 73 74 61  most basic insta
3180: 6c 6c 61 74 69 6f 6e 20 6f 66 20 43 6d 64 72 20  llation of Cmdr 
3190: 72 75 6e 0a 2e 43 53 0a 0a 0a 25 20 2f 70 61 74  run..CS...% /pat
31a0: 68 2f 74 6f 2f 63 6d 64 72 2f 62 75 69 6c 64 5c  h/to/cmdr/build\
31b0: 26 2e 74 63 6c 20 69 6e 73 74 61 6c 6c 0a 0a 2e  &.tcl install...
31c0: 43 45 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20  CE.This command 
31d0: 75 73 65 73 20 74 68 65 20 5c 66 42 6b 65 74 74  uses the \fBkett
31e0: 6c 65 5c 66 52 20 61 70 70 6c 69 63 61 74 69 6f  le\fR applicatio
31f0: 6e 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 0a 2c  n found in the.,
3200: 20 61 6e 64 20 74 68 65 20 61 73 73 6f 63 69 61   and the associa
3210: 74 65 64 20 5c 66 42 74 63 6c 73 68 5c 66 52 5c  ted \fBtclsh\fR\
3220: 26 2e 0a 2e 50 50 0a 54 68 65 20 63 6f 6d 6d 61  &...PP.The comma
3230: 6e 64 20 62 75 69 6c 64 73 20 61 6c 6c 20 70 61  nd builds all pa
3240: 63 6b 61 67 65 73 20 61 6e 64 20 61 70 70 6c 69  ckages and appli
3250: 63 61 74 69 6f 6e 73 20 6f 66 20 43 6d 64 72 2c  cations of Cmdr,
3260: 0a 61 6e 64 20 74 68 65 6e 20 69 6e 73 74 61 6c  .and then instal
3270: 6c 73 20 74 68 65 6d 20 73 6f 20 74 68 61 74 20  ls them so that 
3280: 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 5c  the associated \
3290: 66 42 74 63 6c 73 68 5c 66 52 20 68 61 73 20 61  fBtclsh\fR has a
32a0: 63 63 65 73 73 0a 74 6f 20 74 68 65 6d 5c 26 2e  ccess.to them\&.
32b0: 20 41 6e 79 20 61 70 70 6c 69 63 61 74 69 6f 6e   Any application
32c0: 73 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 73 69  s will become si
32d0: 62 6c 69 6e 67 73 20 6f 66 20 5c 66 42 74 63 6c  blings of \fBtcl
32e0: 73 68 5c 66 52 5c 26 2e 0a 2e 50 50 0a 46 6f 72  sh\fR\&...PP.For
32f0: 20 6d 6f 72 65 20 63 6f 6e 74 72 6f 6c 20 61 62   more control ab
3300: 6f 75 74 20 77 68 69 63 68 20 76 65 72 73 69 6f  out which versio
3310: 6e 20 6f 66 20 5c 66 42 6b 65 74 74 6c 65 5c 66  n of \fBkettle\f
3320: 52 20 61 6e 64 2f 6f 72 0a 5c 66 42 74 63 6c 73  R and/or.\fBtcls
3330: 68 5c 66 52 20 67 65 74 73 20 75 73 65 64 20 72  h\fR gets used r
3340: 75 6e 20 65 69 74 68 65 72 0a 2e 43 53 0a 0a 0a  un either..CS...
3350: 25 20 2f 70 61 74 68 2f 74 6f 2f 6b 65 74 74 6c  % /path/to/kettl
3360: 65 20 2f 70 61 74 68 2f 74 6f 2f 63 6d 64 72 2f  e /path/to/cmdr/
3370: 62 75 69 6c 64 5c 26 2e 74 63 6c 20 69 6e 73 74  build\&.tcl inst
3380: 61 6c 6c 0a 0a 2e 43 45 0a 6f 72 20 65 76 65 6e  all...CE.or even
3390: 0a 2e 43 53 0a 0a 0a 25 20 2f 70 61 74 68 2f 74  ..CS...% /path/t
33a0: 6f 2f 74 63 6c 73 68 20 2f 70 61 74 68 2f 74 6f  o/tclsh /path/to
33b0: 2f 6b 65 74 74 6c 65 20 2f 70 61 74 68 2f 74 6f  /kettle /path/to
33c0: 2f 63 6d 64 72 2f 62 75 69 6c 64 5c 26 2e 74 63  /cmdr/build\&.tc
33d0: 6c 20 69 6e 73 74 61 6c 6c 0a 0a 2e 43 45 0a 74  l install...CE.t
33e0: 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 65 78  o specify the ex
33f0: 61 63 74 20 66 69 6c 65 73 20 74 6f 20 75 73 65  act files to use
3400: 5c 26 2e 0a 2e 50 50 0a 4f 6e 20 57 69 6e 64 6f  \&...PP.On Windo
3410: 77 73 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c  ws it is possibl
3420: 65 20 74 6f 20 69 6e 76 6f 6b 65 20 74 68 65 20  e to invoke the 
3430: 74 68 65 20 66 69 6c 65 20 22 5c 66 49 62 75 69  the file "\fIbui
3440: 6c 64 5c 26 2e 74 63 6c 5c 66 52 22 20 77 69 74  ld\&.tcl\fR" wit
3450: 68 20 61 0a 64 6f 75 62 6c 65 2d 63 6c 69 63 6b  h a.double-click
3460: 5c 26 2e 20 54 68 69 73 20 77 69 6c 6c 20 73 74  \&. This will st
3470: 61 72 74 20 61 20 67 72 61 70 68 69 63 61 6c 20  art a graphical 
3480: 69 6e 74 65 72 66 61 63 65 20 74 6f 20 74 68 65  interface to the
3490: 20 73 79 73 74 65 6d 2c 20 77 69 74 68 0a 62 75   system, with.bu
34a0: 74 74 6f 6e 73 20 66 6f 72 20 61 6c 6c 20 74 68  ttons for all th
34b0: 65 20 70 6f 73 73 69 62 6c 65 20 61 63 74 69 6f  e possible actio
34c0: 6e 73 2c 20 77 68 69 63 68 20 69 6e 63 6c 75 64  ns, which includ
34d0: 65 73 20 27 69 6e 73 74 61 6c 6c 27 61 74 69 6f  es 'install'atio
34e0: 6e 5c 26 2e 0a 2e 50 50 0a 4f 6e 20 75 6e 69 78  n\&...PP.On unix
34f0: 20 74 68 65 20 73 61 6d 65 20 47 55 49 20 69 73   the same GUI is
3500: 20 61 63 65 73 73 69 62 6c 65 20 62 79 20 69 6e   acessible by in
3510: 76 6f 6b 69 6e 67 20 22 5c 66 49 62 75 69 6c 64  voking "\fIbuild
3520: 5c 26 2e 74 63 6c 5c 66 52 22 20 77 69 74 68 20  \&.tcl\fR" with 
3530: 74 68 65 0a 61 72 67 75 6d 65 6e 74 73 20 5c 66  the.arguments \f
3540: 42 67 75 69 5c 66 52 2c 20 69 5c 26 2e 65 5c 26  Bgui\fR, i\&.e\&
3550: 2e 20 61 73 0a 2e 43 53 0a 0a 0a 25 20 2f 70 61  . as..CS...% /pa
3560: 74 68 2f 74 6f 2f 63 6d 64 72 2f 62 75 69 6c 64  th/to/cmdr/build
3570: 5c 26 2e 74 63 6c 20 67 75 69 0a 0a 2e 43 45 0a  \&.tcl gui...CE.
3580: 2e 50 50 0a 54 6f 20 67 65 74 20 68 65 6c 70 20  .PP.To get help 
3590: 61 62 6f 75 74 20 74 68 65 20 6d 65 74 68 6f 64  about the method
35a0: 73 20 6f 66 20 22 5c 66 49 62 75 69 6c 64 5c 26  s of "\fIbuild\&
35b0: 2e 74 63 6c 5c 66 52 22 2c 20 61 6e 64 20 74 68  .tcl\fR", and th
35c0: 65 69 72 20 63 6f 6d 70 6c 65 74 65 0a 73 79 6e  eir complete.syn
35d0: 74 61 78 2c 20 73 69 6d 70 6c 79 20 69 6e 76 6f  tax, simply invo
35e0: 6b 65 20 22 5c 66 49 62 75 69 6c 64 5c 26 2e 74  ke "\fIbuild\&.t
35f0: 63 6c 5c 66 52 22 20 6c 69 6b 65 0a 2e 43 53 0a  cl\fR" like..CS.
3600: 0a 0a 25 20 2f 70 61 74 68 2f 74 6f 2f 63 6d 64  ..% /path/to/cmd
3610: 72 2f 62 75 69 6c 64 5c 26 2e 74 63 6c 20 67 75  r/build\&.tcl gu
3620: 69 0a 0a 2e 43 45 0a 2e 53 48 20 22 52 45 4c 41  i...CE..SH "RELA
3630: 54 45 44 20 44 4f 43 55 4d 45 4e 54 53 22 0a 2e  TED DOCUMENTS"..
3640: 49 50 20 5b 31 5d 0a 5c 66 49 43 6d 64 72 20 2d  IP [1].\fICmdr -
3650: 20 49 6e 74 72 6f 64 75 63 74 69 6f 6e 20 74 6f   Introduction to
3660: 20 74 68 65 20 70 72 6f 6a 65 63 74 5c 66 52 0a   the project\fR.
3670: 2e 49 50 20 5b 32 5d 0a 5c 66 49 43 6d 64 72 20  .IP [2].\fICmdr 
3680: 2d 20 4c 69 63 65 6e 73 65 5c 66 52 0a 2e 49 50  - License\fR..IP
3690: 20 5b 33 5d 0a 5c 66 49 43 6d 64 72 20 2d 20 4c   [3].\fICmdr - L
36a0: 6f 67 20 6f 66 20 43 68 61 6e 67 65 73 5c 66 52  og of Changes\fR
36b0: 0a 2e 49 50 20 5b 34 5d 0a 5c 66 49 43 6d 64 72  ..IP [4].\fICmdr
36c0: 20 2d 20 48 6f 77 20 54 6f 20 47 65 74 20 54 68   - How To Get Th
36d0: 65 20 53 6f 75 72 63 65 73 5c 66 52 0a 2e 49 50  e Sources\fR..IP
36e0: 20 5b 35 5d 0a 5c 66 49 43 6d 64 72 20 2d 20 54   [5].\fICmdr - T
36f0: 68 65 20 49 6e 73 74 61 6c 6c 65 72 27 73 20 47  he Installer's G
3700: 75 69 64 65 5c 66 52 0a 2e 49 50 20 5b 36 5d 0a  uide\fR..IP [6].
3710: 5c 66 49 43 6d 64 72 20 2d 20 54 68 65 20 44 65  \fICmdr - The De
3720: 76 65 6c 6f 70 65 72 27 73 20 47 75 69 64 65 5c  veloper's Guide\
3730: 66 52 0a 2e 50 50 0a 2e 53 48 20 22 42 55 47 53  fR..PP..SH "BUGS
3740: 2c 20 49 44 45 41 53 2c 20 46 45 45 44 42 41 43  , IDEAS, FEEDBAC
3750: 4b 22 0a 42 6f 74 68 20 74 68 65 20 70 61 63 6b  K".Both the pack
3760: 61 67 65 28 73 29 20 61 6e 64 20 74 68 69 73 20  age(s) and this 
3770: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 77 69  documentation wi
3780: 6c 6c 20 75 6e 64 6f 75 62 74 65 64 6c 79 20 63  ll undoubtedly c
3790: 6f 6e 74 61 69 6e 0a 62 75 67 73 20 61 6e 64 20  ontain.bugs and 
37a0: 6f 74 68 65 72 20 70 72 6f 62 6c 65 6d 73 5c 26  other problems\&
37b0: 2e 0a 50 6c 65 61 73 65 20 72 65 70 6f 72 74 20  ..Please report 
37c0: 73 75 63 68 20 61 74 0a 5c 66 49 43 6d 64 72 20  such at.\fICmdr 
37d0: 54 69 63 6b 65 74 73 5c 66 52 20 5b 68 74 74 70  Tickets\fR [http
37e0: 73 3a 2f 63 6f 72 65 5c 26 2e 74 63 6c 5c 26 2e  s:/core\&.tcl\&.
37f0: 74 6b 2f 61 6b 75 70 72 69 65 73 2f 63 6d 64 72  tk/akupries/cmdr
3800: 5d 5c 26 2e 0a 2e 50 50 0a 50 6c 65 61 73 65 20  ]\&...PP.Please 
3810: 61 6c 73 6f 20 72 65 70 6f 72 74 20 61 6e 79 20  also report any 
3820: 69 64 65 61 73 20 79 6f 75 20 6d 61 79 20 68 61  ideas you may ha
3830: 76 65 20 66 6f 72 20 65 6e 68 61 6e 63 65 6d 65  ve for enhanceme
3840: 6e 74 73 20 6f 66 0a 65 69 74 68 65 72 20 70 61  nts of.either pa
3850: 63 6b 61 67 65 28 73 29 20 61 6e 64 2f 6f 72 20  ckage(s) and/or 
3860: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 5c 26 2e  documentation\&.
3870: 0a 2e 53 48 20 4b 45 59 57 4f 52 44 53 0a 61 72  ..SH KEYWORDS.ar
3880: 67 75 6d 65 6e 74 73 2c 20 63 6f 6d 6d 61 6e 64  guments, command
3890: 20 68 69 65 72 61 72 63 68 79 2c 20 63 6f 6d 6d   hierarchy, comm
38a0: 61 6e 64 20 6c 69 6e 65 20 63 6f 6d 70 6c 65 74  and line complet
38b0: 69 6f 6e 2c 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e  ion, command lin
38c0: 65 20 68 61 6e 64 6c 69 6e 67 2c 20 63 6f 6d 6d  e handling, comm
38d0: 61 6e 64 20 74 72 65 65 2c 20 65 64 69 74 69 6e  and tree, editin
38e0: 67 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2c 20  g command line, 
38f0: 68 65 6c 70 20 66 6f 72 20 63 6f 6d 6d 61 6e 64  help for command
3900: 20 6c 69 6e 65 2c 20 68 69 65 72 61 72 63 68 79   line, hierarchy
3910: 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 2c 20 69 6e   of commands, in
3920: 74 65 72 61 63 74 69 76 65 20 63 6f 6d 6d 61 6e  teractive comman
3930: 64 20 73 68 65 6c 6c 2c 20 6f 70 74 69 6f 6e 61  d shell, optiona
3940: 6c 20 61 72 67 75 6d 65 6e 74 73 2c 20 6f 70 74  l arguments, opt
3950: 69 6f 6e 73 2c 20 70 61 72 61 6d 65 74 65 72 73  ions, parameters
3960: 2c 20 70 72 6f 63 65 73 73 69 6e 67 20 63 6f 6d  , processing com
3970: 6d 61 6e 64 20 6c 69 6e 65 2c 20 74 72 65 65 20  mand line, tree 
3980: 6f 66 20 63 6f 6d 6d 61 6e 64 73 0a 2e 53 48 20  of commands..SH 
3990: 43 4f 50 59 52 49 47 48 54 0a 2e 6e 66 0a 43 6f  COPYRIGHT..nf.Co
39a0: 70 79 72 69 67 68 74 20 28 63 29 20 32 30 31 33  pyright (c) 2013
39b0: 2d 32 30 31 36 20 41 6e 64 72 65 61 73 20 4b 75  -2016 Andreas Ku
39c0: 70 72 69 65 73 0a 43 6f 70 79 72 69 67 68 74 20  pries.Copyright 
39d0: 28 63 29 20 32 30 31 33 2d 32 30 31 36 20 44 6f  (c) 2013-2016 Do
39e0: 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 41 6e 64  cumentation, And
39f0: 72 65 61 73 20 4b 75 70 72 69 65 73 0a 0a 2e 66  reas Kupries...f
3a00: 69                                               i