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 70f121f550dae3c8969f05ab597b683006f1e3ff:


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 63 6f 6e 66 69 67 5c 26 2e 6d 61 6e 27 20  r_config\&.man' 
0030: 62 79 20 74 63 6c 6c 69 62 2f 64 6f 63 74 6f 6f  by tcllib/doctoo
0040: 6c 73 20 77 69 74 68 20 66 6f 72 6d 61 74 20 27  ls with format '
0050: 6e 72 6f 66 66 27 0a 27 5c 22 20 43 6f 70 79 72  nroff'.'\" Copyr
0060: 69 67 68 74 20 28 63 29 20 32 30 31 33 2d 32 30  ight (c) 2013-20
0070: 31 36 20 41 6e 64 72 65 61 73 20 4b 75 70 72 69  16 Andreas Kupri
0080: 65 73 0a 27 5c 22 20 43 6f 70 79 72 69 67 68 74  es.'\" Copyright
0090: 20 28 63 29 20 32 30 31 33 2d 32 30 31 36 20 44   (c) 2013-2016 D
00a0: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c 20 41 6e  ocumentation, An
00b0: 64 72 65 61 73 20 4b 75 70 72 69 65 73 0a 27 5c  dreas Kupries.'\
00c0: 22 0a 2e 54 48 20 22 63 6d 64 72 3a 3a 63 6f 6e  "..TH "cmdr::con
00d0: 66 69 67 22 20 6e 20 31 5c 26 2e 32 20 64 6f 63  fig" n 1\&.2 doc
00e0: 20 22 43 6d 64 72 2c 20 61 20 66 72 61 6d 65 77   "Cmdr, a framew
00f0: 6f 72 6b 20 66 6f 72 20 63 6f 6d 6d 61 6e 64 20  ork for command 
0100: 6c 69 6e 65 20 70 61 72 73 69 6e 67 20 61 6e 64  line parsing and
0110: 20 64 69 73 70 61 74 63 68 22 0a 2e 5c 22 20 54   dispatch"..\" T
0120: 68 65 20 2d 2a 2d 20 6e 72 6f 66 66 20 2d 2a 2d  he -*- nroff -*-
0130: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 62 65 6c   definitions bel
0140: 6f 77 20 61 72 65 20 66 6f 72 20 73 75 70 70 6c  ow are for suppl
0150: 65 6d 65 6e 74 61 6c 20 6d 61 63 72 6f 73 20 75  emental macros u
0160: 73 65 64 0a 2e 5c 22 20 69 6e 20 54 63 6c 2f 54  sed..\" in Tcl/T
0170: 6b 20 6d 61 6e 75 61 6c 20 65 6e 74 72 69 65 73  k manual entries
0180: 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 41 50 20 74 79  ...\"..\" .AP ty
0190: 70 65 20 6e 61 6d 65 20 69 6e 2f 6f 75 74 20 3f  pe name in/out ?
01a0: 69 6e 64 65 6e 74 3f 0a 2e 5c 22 09 53 74 61 72  indent?..\".Star
01b0: 74 20 70 61 72 61 67 72 61 70 68 20 64 65 73 63  t paragraph desc
01c0: 72 69 62 69 6e 67 20 61 6e 20 61 72 67 75 6d 65  ribing an argume
01d0: 6e 74 20 74 6f 20 61 20 6c 69 62 72 61 72 79 20  nt to a library 
01e0: 70 72 6f 63 65 64 75 72 65 2e 0a 2e 5c 22 09 74  procedure...\".t
01f0: 79 70 65 20 69 73 20 74 79 70 65 20 6f 66 20 61  ype is type of a
0200: 72 67 75 6d 65 6e 74 20 28 69 6e 74 2c 20 65 74  rgument (int, et
0210: 63 2e 29 2c 20 69 6e 2f 6f 75 74 20 69 73 20 65  c.), in/out is e
0220: 69 74 68 65 72 20 22 69 6e 22 2c 20 22 6f 75 74  ither "in", "out
0230: 22 2c 0a 2e 5c 22 09 6f 72 20 22 69 6e 2f 6f 75  ",..\".or "in/ou
0240: 74 22 20 74 6f 20 64 65 73 63 72 69 62 65 20 77  t" to describe w
0250: 68 65 74 68 65 72 20 70 72 6f 63 65 64 75 72 65  hether procedure
0260: 20 72 65 61 64 73 20 6f 72 20 6d 6f 64 69 66 69   reads or modifi
0270: 65 73 20 61 72 67 2c 0a 2e 5c 22 09 61 6e 64 20  es arg,..\".and 
0280: 69 6e 64 65 6e 74 20 69 73 20 65 71 75 69 76 61  indent is equiva
0290: 6c 65 6e 74 20 74 6f 20 73 65 63 6f 6e 64 20 61  lent to second a
02a0: 72 67 20 6f 66 20 2e 49 50 20 28 73 68 6f 75 6c  rg of .IP (shoul
02b0: 64 6e 27 74 20 65 76 65 72 20 62 65 0a 2e 5c 22  dn't ever be..\"
02c0: 09 6e 65 65 64 65 64 3b 20 20 75 73 65 20 2e 41  .needed;  use .A
02d0: 53 20 62 65 6c 6f 77 20 69 6e 73 74 65 61 64 29  S below instead)
02e0: 0a 2e 5c 22 0a 2e 5c 22 20 2e 41 53 20 3f 74 79  ..\"..\" .AS ?ty
02f0: 70 65 3f 20 3f 6e 61 6d 65 3f 0a 2e 5c 22 09 47  pe? ?name?..\".G
0300: 69 76 65 20 6d 61 78 69 6d 75 6d 20 73 69 7a 65  ive maximum size
0310: 73 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 66  s of arguments f
0320: 6f 72 20 73 65 74 74 69 6e 67 20 74 61 62 20 73  or setting tab s
0330: 74 6f 70 73 2e 20 20 54 79 70 65 20 61 6e 64 0a  tops.  Type and.
0340: 2e 5c 22 09 6e 61 6d 65 20 61 72 65 20 65 78 61  .\".name are exa
0350: 6d 70 6c 65 73 20 6f 66 20 6c 61 72 67 65 73 74  mples of largest
0360: 20 70 6f 73 73 69 62 6c 65 20 61 72 67 75 6d 65   possible argume
0370: 6e 74 73 20 74 68 61 74 20 77 69 6c 6c 20 62 65  nts that will be
0380: 20 70 61 73 73 65 64 0a 2e 5c 22 09 74 6f 20 2e   passed..\".to .
0390: 41 50 20 6c 61 74 65 72 2e 20 20 49 66 20 61 72  AP later.  If ar
03a0: 67 73 20 61 72 65 20 6f 6d 69 74 74 65 64 2c 20  gs are omitted, 
03b0: 64 65 66 61 75 6c 74 20 74 61 62 20 73 74 6f 70  default tab stop
03c0: 73 20 61 72 65 20 75 73 65 64 2e 0a 2e 5c 22 0a  s are used...\".
03d0: 2e 5c 22 20 2e 42 53 0a 2e 5c 22 09 53 74 61 72  .\" .BS..\".Star
03e0: 74 20 62 6f 78 20 65 6e 63 6c 6f 73 75 72 65 2e  t box enclosure.
03f0: 20 20 46 72 6f 6d 20 68 65 72 65 20 75 6e 74 69    From here unti
0400: 6c 20 6e 65 78 74 20 2e 42 45 2c 20 65 76 65 72  l next .BE, ever
0410: 79 74 68 69 6e 67 20 77 69 6c 6c 20 62 65 0a 2e  ything will be..
0420: 5c 22 09 65 6e 63 6c 6f 73 65 64 20 69 6e 20 6f  \".enclosed in o
0430: 6e 65 20 6c 61 72 67 65 20 62 6f 78 2e 0a 2e 5c  ne large box...\
0440: 22 0a 2e 5c 22 20 2e 42 45 0a 2e 5c 22 09 45 6e  "..\" .BE..\".En
0450: 64 20 6f 66 20 62 6f 78 20 65 6e 63 6c 6f 73 75  d of box enclosu
0460: 72 65 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 43 53 0a  re...\"..\" .CS.
0470: 2e 5c 22 09 42 65 67 69 6e 20 63 6f 64 65 20 65  .\".Begin code e
0480: 78 63 65 72 70 74 2e 0a 2e 5c 22 0a 2e 5c 22 20  xcerpt...\"..\" 
0490: 2e 43 45 0a 2e 5c 22 09 45 6e 64 20 63 6f 64 65  .CE..\".End code
04a0: 20 65 78 63 65 72 70 74 2e 0a 2e 5c 22 0a 2e 5c   excerpt...\"..\
04b0: 22 20 2e 56 53 20 3f 76 65 72 73 69 6f 6e 3f 20  " .VS ?version? 
04c0: 3f 62 72 3f 0a 2e 5c 22 09 42 65 67 69 6e 20 76  ?br?..\".Begin v
04d0: 65 72 74 69 63 61 6c 20 73 69 64 65 62 61 72 2c  ertical sidebar,
04e0: 20 66 6f 72 20 75 73 65 20 69 6e 20 6d 61 72 6b   for use in mark
04f0: 69 6e 67 20 6e 65 77 6c 79 2d 63 68 61 6e 67 65  ing newly-change
0500: 64 20 70 61 72 74 73 0a 2e 5c 22 09 6f 66 20 6d  d parts..\".of m
0510: 61 6e 20 70 61 67 65 73 2e 20 20 54 68 65 20 66  an pages.  The f
0520: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73  irst argument is
0530: 20 69 67 6e 6f 72 65 64 20 61 6e 64 20 75 73 65   ignored and use
0540: 64 20 66 6f 72 20 72 65 63 6f 72 64 69 6e 67 0a  d for recording.
0550: 2e 5c 22 09 74 68 65 20 76 65 72 73 69 6f 6e 20  .\".the version 
0560: 77 68 65 6e 20 74 68 65 20 2e 56 53 20 77 61 73  when the .VS was
0570: 20 61 64 64 65 64 2c 20 73 6f 20 74 68 61 74 20   added, so that 
0580: 74 68 65 20 73 69 64 65 62 61 72 73 20 63 61 6e  the sidebars can
0590: 20 62 65 0a 2e 5c 22 09 66 6f 75 6e 64 20 61 6e   be..\".found an
05a0: 64 20 72 65 6d 6f 76 65 64 20 77 68 65 6e 20 74  d removed when t
05b0: 68 65 79 20 72 65 61 63 68 20 61 20 63 65 72 74  hey reach a cert
05c0: 61 69 6e 20 61 67 65 2e 20 20 49 66 20 61 6e 6f  ain age.  If ano
05d0: 74 68 65 72 20 61 72 67 75 6d 65 6e 74 0a 2e 5c  ther argument..\
05e0: 22 09 69 73 20 70 72 65 73 65 6e 74 2c 20 74 68  ".is present, th
05f0: 65 6e 20 61 20 6c 69 6e 65 20 62 72 65 61 6b 20  en a line break 
0600: 69 73 20 66 6f 72 63 65 64 20 62 65 66 6f 72 65  is forced before
0610: 20 73 74 61 72 74 69 6e 67 20 74 68 65 20 73 69   starting the si
0620: 64 65 62 61 72 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e  debar...\"..\" .
0630: 56 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 76 65  VE..\".End of ve
0640: 72 74 69 63 61 6c 20 73 69 64 65 62 61 72 2e 0a  rtical sidebar..
0650: 2e 5c 22 0a 2e 5c 22 20 2e 44 53 0a 2e 5c 22 09  .\"..\" .DS..\".
0660: 42 65 67 69 6e 20 61 6e 20 69 6e 64 65 6e 74 65  Begin an indente
0670: 64 20 75 6e 66 69 6c 6c 65 64 20 64 69 73 70 6c  d unfilled displ
0680: 61 79 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 44 45 0a  ay...\"..\" .DE.
0690: 2e 5c 22 09 45 6e 64 20 6f 66 20 69 6e 64 65 6e  .\".End of inden
06a0: 74 65 64 20 75 6e 66 69 6c 6c 65 64 20 64 69 73  ted unfilled dis
06b0: 70 6c 61 79 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 53  play...\"..\" .S
06c0: 4f 20 3f 6d 61 6e 70 61 67 65 3f 0a 2e 5c 22 09  O ?manpage?..\".
06d0: 53 74 61 72 74 20 6f 66 20 6c 69 73 74 20 6f 66  Start of list of
06e0: 20 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e   standard option
06f0: 73 20 66 6f 72 20 61 20 54 6b 20 77 69 64 67 65  s for a Tk widge
0700: 74 2e 20 54 68 65 20 6d 61 6e 70 61 67 65 0a 2e  t. The manpage..
0710: 5c 22 09 61 72 67 75 6d 65 6e 74 20 64 65 66 69  \".argument defi
0720: 6e 65 73 20 77 68 65 72 65 20 74 6f 20 6c 6f 6f  nes where to loo
0730: 6b 20 75 70 20 74 68 65 20 73 74 61 6e 64 61 72  k up the standar
0740: 64 20 6f 70 74 69 6f 6e 73 3b 20 69 66 0a 2e 5c  d options; if..\
0750: 22 09 6f 6d 69 74 74 65 64 2c 20 64 65 66 61 75  ".omitted, defau
0760: 6c 74 73 20 74 6f 20 22 6f 70 74 69 6f 6e 73 22  lts to "options"
0770: 2e 20 54 68 65 20 6f 70 74 69 6f 6e 73 20 66 6f  . The options fo
0780: 6c 6c 6f 77 20 6f 6e 20 73 75 63 63 65 73 73 69  llow on successi
0790: 76 65 0a 2e 5c 22 09 6c 69 6e 65 73 2c 20 69 6e  ve..\".lines, in
07a0: 20 74 68 72 65 65 20 63 6f 6c 75 6d 6e 73 20 73   three columns s
07b0: 65 70 61 72 61 74 65 64 20 62 79 20 74 61 62 73  eparated by tabs
07c0: 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 53 45 0a 2e 5c  ...\"..\" .SE..\
07d0: 22 09 45 6e 64 20 6f 66 20 6c 69 73 74 20 6f 66  ".End of list of
07e0: 20 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e   standard option
07f0: 73 20 66 6f 72 20 61 20 54 6b 20 77 69 64 67 65  s for a Tk widge
0800: 74 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 4f 50 20 63  t...\"..\" .OP c
0810: 6d 64 4e 61 6d 65 20 64 62 4e 61 6d 65 20 64 62  mdName dbName db
0820: 43 6c 61 73 73 0a 2e 5c 22 09 53 74 61 72 74 20  Class..\".Start 
0830: 6f 66 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f  of description o
0840: 66 20 61 20 73 70 65 63 69 66 69 63 20 6f 70 74  f a specific opt
0850: 69 6f 6e 2e 20 20 63 6d 64 4e 61 6d 65 20 67 69  ion.  cmdName gi
0860: 76 65 73 20 74 68 65 0a 2e 5c 22 09 6f 70 74 69  ves the..\".opti
0870: 6f 6e 27 73 20 6e 61 6d 65 20 61 73 20 73 70 65  on's name as spe
0880: 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 63 6c  cified in the cl
0890: 61 73 73 20 63 6f 6d 6d 61 6e 64 2c 20 64 62 4e  ass command, dbN
08a0: 61 6d 65 20 67 69 76 65 73 0a 2e 5c 22 09 74 68  ame gives..\".th
08b0: 65 20 6f 70 74 69 6f 6e 27 73 20 6e 61 6d 65 20  e option's name 
08c0: 69 6e 20 74 68 65 20 6f 70 74 69 6f 6e 20 64 61  in the option da
08d0: 74 61 62 61 73 65 2c 20 61 6e 64 20 64 62 43 6c  tabase, and dbCl
08e0: 61 73 73 20 67 69 76 65 73 0a 2e 5c 22 09 74 68  ass gives..\".th
08f0: 65 20 6f 70 74 69 6f 6e 27 73 20 63 6c 61 73 73  e option's class
0900: 20 69 6e 20 74 68 65 20 6f 70 74 69 6f 6e 20 64   in the option d
0910: 61 74 61 62 61 73 65 2e 0a 2e 5c 22 0a 2e 5c 22  atabase...\"..\"
0920: 20 2e 55 4c 20 61 72 67 31 20 61 72 67 32 0a 2e   .UL arg1 arg2..
0930: 5c 22 09 50 72 69 6e 74 20 61 72 67 31 20 75 6e  \".Print arg1 un
0940: 64 65 72 6c 69 6e 65 64 2c 20 74 68 65 6e 20 70  derlined, then p
0950: 72 69 6e 74 20 61 72 67 32 20 6e 6f 72 6d 61 6c  rint arg2 normal
0960: 6c 79 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 51 57 20  ly...\"..\" .QW 
0970: 61 72 67 31 20 3f 61 72 67 32 3f 0a 2e 5c 22 09  arg1 ?arg2?..\".
0980: 50 72 69 6e 74 20 61 72 67 31 20 69 6e 20 71 75  Print arg1 in qu
0990: 6f 74 65 73 2c 20 74 68 65 6e 20 61 72 67 32 20  otes, then arg2 
09a0: 6e 6f 72 6d 61 6c 6c 79 20 28 66 6f 72 20 74 72  normally (for tr
09b0: 61 69 6c 69 6e 67 20 70 75 6e 63 74 75 61 74 69  ailing punctuati
09c0: 6f 6e 29 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 50 51  on)...\"..\" .PQ
09d0: 20 61 72 67 31 20 3f 61 72 67 32 3f 0a 2e 5c 22   arg1 ?arg2?..\"
09e0: 09 50 72 69 6e 74 20 61 6e 20 6f 70 65 6e 20 70  .Print an open p
09f0: 61 72 65 6e 74 68 65 73 69 73 2c 20 61 72 67 31  arenthesis, arg1
0a00: 20 69 6e 20 71 75 6f 74 65 73 2c 20 74 68 65 6e   in quotes, then
0a10: 20 61 72 67 32 20 6e 6f 72 6d 61 6c 6c 79 0a 2e   arg2 normally..
0a20: 5c 22 09 28 66 6f 72 20 74 72 61 69 6c 69 6e 67  \".(for trailing
0a30: 20 70 75 6e 63 74 75 61 74 69 6f 6e 29 20 61 6e   punctuation) an
0a40: 64 20 74 68 65 6e 20 61 20 63 6c 6f 73 69 6e 67  d then a closing
0a50: 20 70 61 72 65 6e 74 68 65 73 69 73 2e 0a 2e 5c   parenthesis...\
0a60: 22 0a 2e 5c 22 09 23 20 53 65 74 20 75 70 20 74  "..\".# Set up t
0a70: 72 61 70 73 20 61 6e 64 20 6f 74 68 65 72 20 6d  raps and other m
0a80: 69 73 63 65 6c 6c 61 6e 65 6f 75 73 20 73 74 75  iscellaneous stu
0a90: 66 66 20 66 6f 72 20 54 63 6c 2f 54 6b 20 6d 61  ff for Tcl/Tk ma
0aa0: 6e 20 70 61 67 65 73 2e 0a 2e 69 66 20 74 20 2e  n pages...if t .
0ab0: 77 68 20 2d 31 2e 33 69 20 5e 42 0a 2e 6e 72 20  wh -1.3i ^B..nr 
0ac0: 5e 6c 20 5c 6e 28 2e 6c 0a 2e 61 64 20 62 0a 2e  ^l \n(.l..ad b..
0ad0: 5c 22 09 23 20 53 74 61 72 74 20 61 6e 20 61 72  \".# Start an ar
0ae0: 67 75 6d 65 6e 74 20 64 65 73 63 72 69 70 74 69  gument descripti
0af0: 6f 6e 0a 2e 64 65 20 41 50 0a 2e 69 65 20 21 22  on..de AP..ie !"
0b00: 5c 5c 24 34 22 22 20 2e 54 50 20 5c 5c 24 34 0a  \\$4"" .TP \\$4.
0b10: 2e 65 6c 20 5c 7b 5c 0a 2e 20 20 20 69 65 20 21  .el \{\..   ie !
0b20: 22 5c 5c 24 32 22 22 20 2e 54 50 20 5c 5c 6e 28  "\\$2"" .TP \\n(
0b30: 29 43 75 0a 2e 20 20 20 65 6c 20 20 20 20 20 20  )Cu..   el      
0b40: 20 20 20 20 2e 54 50 20 31 35 0a 2e 5c 7d 0a 2e      .TP 15..\}..
0b50: 74 61 20 5c 5c 6e 28 29 41 75 20 5c 5c 6e 28 29  ta \\n()Au \\n()
0b60: 42 75 0a 2e 69 65 20 21 22 5c 5c 24 33 22 22 20  Bu..ie !"\\$3"" 
0b70: 5c 7b 5c 0a 5c 26 5c 5c 24 31 20 5c 5c 66 49 5c  \{\.\&\\$1 \\fI\
0b80: 5c 24 32 5c 5c 66 50 20 28 5c 5c 24 33 29 0a 2e  \$2\\fP (\\$3)..
0b90: 5c 22 2e 62 0a 2e 5c 7d 0a 2e 65 6c 20 5c 7b 5c  \".b..\}..el \{\
0ba0: 0a 2e 62 72 0a 2e 69 65 20 21 22 5c 5c 24 32 22  ..br..ie !"\\$2"
0bb0: 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 31 09 5c 5c 66  " \{\.\&\\$1.\\f
0bc0: 49 5c 5c 24 32 5c 5c 66 50 0a 2e 5c 7d 0a 2e 65  I\\$2\\fP..\}..e
0bd0: 6c 20 5c 7b 5c 0a 5c 26 5c 5c 66 49 5c 5c 24 31  l \{\.\&\\fI\\$1
0be0: 5c 5c 66 50 0a 2e 5c 7d 0a 2e 5c 7d 0a 2e 2e 0a  \\fP..\}..\}....
0bf0: 2e 5c 22 09 23 20 64 65 66 69 6e 65 20 74 61 62  .\".# define tab
0c00: 62 69 6e 67 20 76 61 6c 75 65 73 20 66 6f 72 20  bing values for 
0c10: 2e 41 50 0a 2e 64 65 20 41 53 0a 2e 6e 72 20 29  .AP..de AS..nr )
0c20: 41 20 31 30 6e 0a 2e 69 66 20 21 22 5c 5c 24 31  A 10n..if !"\\$1
0c30: 22 22 20 2e 6e 72 20 29 41 20 5c 5c 77 27 5c 5c  "" .nr )A \\w'\\
0c40: 24 31 27 75 2b 33 6e 0a 2e 6e 72 20 29 42 20 5c  $1'u+3n..nr )B \
0c50: 5c 6e 28 29 41 75 2b 31 35 6e 0a 2e 5c 22 0a 2e  \n()Au+15n..\"..
0c60: 69 66 20 21 22 5c 5c 24 32 22 22 20 2e 6e 72 20  if !"\\$2"" .nr 
0c70: 29 42 20 5c 5c 77 27 5c 5c 24 32 27 75 2b 5c 5c  )B \\w'\\$2'u+\\
0c80: 6e 28 29 41 75 2b 33 6e 0a 2e 6e 72 20 29 43 20  n()Au+3n..nr )C 
0c90: 5c 5c 6e 28 29 42 75 2b 5c 5c 77 27 28 69 6e 2f  \\n()Bu+\\w'(in/
0ca0: 6f 75 74 29 27 75 2b 32 6e 0a 2e 2e 0a 2e 41 53  out)'u+2n.....AS
0cb0: 20 54 63 6c 5f 49 6e 74 65 72 70 20 54 63 6c 5f   Tcl_Interp Tcl_
0cc0: 43 72 65 61 74 65 49 6e 74 65 72 70 20 69 6e 2f  CreateInterp in/
0cd0: 6f 75 74 0a 2e 5c 22 09 23 20 42 53 20 2d 20 73  out..\".# BS - s
0ce0: 74 61 72 74 20 62 6f 78 65 64 20 74 65 78 74 0a  tart boxed text.
0cf0: 2e 5c 22 09 23 20 5e 79 20 3d 20 73 74 61 72 74  .\".# ^y = start
0d00: 69 6e 67 20 79 20 6c 6f 63 61 74 69 6f 6e 0a 2e  ing y location..
0d10: 5c 22 09 23 20 5e 62 20 3d 20 31 0a 2e 64 65 20  \".# ^b = 1..de 
0d20: 42 53 0a 2e 62 72 0a 2e 6d 6b 20 5e 79 0a 2e 6e  BS..br..mk ^y..n
0d30: 72 20 5e 62 20 31 75 0a 2e 69 66 20 6e 20 2e 6e  r ^b 1u..if n .n
0d40: 66 0a 2e 69 66 20 6e 20 2e 74 69 20 30 0a 2e 69  f..if n .ti 0..i
0d50: 66 20 6e 20 5c 6c 27 5c 5c 6e 28 2e 6c 75 5c 28  f n \l'\\n(.lu\(
0d60: 75 6c 27 0a 2e 69 66 20 6e 20 2e 66 69 0a 2e 2e  ul'..if n .fi...
0d70: 0a 2e 5c 22 09 23 20 42 45 20 2d 20 65 6e 64 20  ..\".# BE - end 
0d80: 62 6f 78 65 64 20 74 65 78 74 20 28 64 72 61 77  boxed text (draw
0d90: 20 62 6f 78 20 6e 6f 77 29 0a 2e 64 65 20 42 45   box now)..de BE
0da0: 0a 2e 6e 66 0a 2e 74 69 20 30 0a 2e 6d 6b 20 5e  ..nf..ti 0..mk ^
0db0: 74 0a 2e 69 65 20 6e 20 5c 6c 27 5c 5c 6e 28 5e  t..ie n \l'\\n(^
0dc0: 6c 75 5c 28 75 6c 27 0a 2e 65 6c 20 5c 7b 5c 0a  lu\(ul'..el \{\.
0dd0: 2e 5c 22 09 44 72 61 77 20 66 6f 75 72 2d 73 69  .\".Draw four-si
0de0: 64 65 64 20 62 6f 78 20 6e 6f 72 6d 61 6c 6c 79  ded box normally
0df0: 2c 20 62 75 74 20 64 6f 6e 27 74 20 64 72 61 77  , but don't draw
0e00: 20 74 6f 70 20 6f 66 0a 2e 5c 22 09 62 6f 78 20   top of..\".box 
0e10: 69 66 20 74 68 65 20 62 6f 78 20 73 74 61 72 74  if the box start
0e20: 65 64 20 6f 6e 20 61 6e 20 65 61 72 6c 69 65 72  ed on an earlier
0e30: 20 70 61 67 65 2e 0a 2e 69 65 20 21 5c 5c 6e 28   page...ie !\\n(
0e40: 5e 62 2d 31 20 5c 7b 5c 0a 5c 68 27 2d 31 2e 35  ^b-1 \{\.\h'-1.5
0e50: 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 79 75 2d 31 76  n'\L'|\\n(^yu-1v
0e60: 27 5c 6c 27 5c 5c 6e 28 5e 6c 75 2b 33 6e 5c 28  '\l'\\n(^lu+3n\(
0e70: 75 6c 27 5c 4c 27 5c 5c 6e 28 5e 74 75 2b 31 76  ul'\L'\\n(^tu+1v
0e80: 2d 5c 5c 6e 28 5e 79 75 27 5c 6c 27 7c 30 75 2d  -\\n(^yu'\l'|0u-
0e90: 31 2e 35 6e 5c 28 75 6c 27 0a 2e 5c 7d 0a 2e 65  1.5n\(ul'..\}..e
0ea0: 6c 20 5c 7d 5c 0a 5c 68 27 2d 31 2e 35 6e 27 5c  l \}\.\h'-1.5n'\
0eb0: 4c 27 7c 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c 68  L'|\\n(^yu-1v'\h
0ec0: 27 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 5c 4c 27 5c  '\\n(^lu+3n'\L'\
0ed0: 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79  \n(^tu+1v-\\n(^y
0ee0: 75 27 5c 6c 27 7c 30 75 2d 31 2e 35 6e 5c 28 75  u'\l'|0u-1.5n\(u
0ef0: 6c 27 0a 2e 5c 7d 0a 2e 5c 7d 0a 2e 66 69 0a 2e  l'..\}..\}..fi..
0f00: 62 72 0a 2e 6e 72 20 5e 62 20 30 0a 2e 2e 0a 2e  br..nr ^b 0.....
0f10: 5c 22 09 23 20 56 53 20 2d 20 73 74 61 72 74 20  \".# VS - start 
0f20: 76 65 72 74 69 63 61 6c 20 73 69 64 65 62 61 72  vertical sidebar
0f30: 0a 2e 5c 22 09 23 20 5e 59 20 3d 20 73 74 61 72  ..\".# ^Y = star
0f40: 74 69 6e 67 20 79 20 6c 6f 63 61 74 69 6f 6e 0a  ting y location.
0f50: 2e 5c 22 09 23 20 5e 76 20 3d 20 31 20 28 66 6f  .\".# ^v = 1 (fo
0f60: 72 20 74 72 6f 66 66 3b 20 20 66 6f 72 20 6e 72  r troff;  for nr
0f70: 6f 66 66 20 74 68 69 73 20 64 6f 65 73 6e 27 74  off this doesn't
0f80: 20 6d 61 74 74 65 72 29 0a 2e 64 65 20 56 53 0a   matter)..de VS.
0f90: 2e 69 66 20 21 22 5c 5c 24 32 22 22 20 2e 62 72  .if !"\\$2"" .br
0fa0: 0a 2e 6d 6b 20 5e 59 0a 2e 69 65 20 6e 20 27 6d  ..mk ^Y..ie n 'm
0fb0: 63 20 5c 73 31 32 5c 28 62 72 5c 73 30 0a 2e 65  c \s12\(br\s0..e
0fc0: 6c 20 2e 6e 72 20 5e 76 20 31 75 0a 2e 2e 0a 2e  l .nr ^v 1u.....
0fd0: 5c 22 09 23 20 56 45 20 2d 20 65 6e 64 20 6f 66  \".# VE - end of
0fe0: 20 76 65 72 74 69 63 61 6c 20 73 69 64 65 62 61   vertical sideba
0ff0: 72 0a 2e 64 65 20 56 45 0a 2e 69 65 20 6e 20 27  r..de VE..ie n '
1000: 6d 63 0a 2e 65 6c 20 5c 7b 5c 0a 2e 65 76 20 32  mc..el \{\..ev 2
1010: 0a 2e 6e 66 0a 2e 74 69 20 30 0a 2e 6d 6b 20 5e  ..nf..ti 0..mk ^
1020: 74 0a 5c 68 27 7c 5c 5c 6e 28 5e 6c 75 2b 33 6e  t.\h'|\\n(^lu+3n
1030: 27 5c 4c 27 7c 5c 5c 6e 28 5e 59 75 2d 31 76 5c  '\L'|\\n(^Yu-1v\
1040: 28 62 76 27 5c 76 27 5c 5c 6e 28 5e 74 75 2b 31  (bv'\v'\\n(^tu+1
1050: 76 2d 5c 5c 6e 28 5e 59 75 27 5c 68 27 2d 7c 5c  v-\\n(^Yu'\h'-|\
1060: 5c 6e 28 5e 6c 75 2b 33 6e 27 0a 2e 73 70 20 2d  \n(^lu+3n'..sp -
1070: 31 0a 2e 66 69 0a 2e 65 76 0a 2e 5c 7d 0a 2e 6e  1..fi..ev..\}..n
1080: 72 20 5e 76 20 30 0a 2e 2e 0a 2e 5c 22 09 23 20  r ^v 0.....\".# 
1090: 53 70 65 63 69 61 6c 20 6d 61 63 72 6f 20 74 6f  Special macro to
10a0: 20 68 61 6e 64 6c 65 20 70 61 67 65 20 62 6f 74   handle page bot
10b0: 74 6f 6d 3a 20 20 66 69 6e 69 73 68 20 6f 66 66  tom:  finish off
10c0: 20 63 75 72 72 65 6e 74 0a 2e 5c 22 09 23 20 62   current..\".# b
10d0: 6f 78 2f 73 69 64 65 62 61 72 20 69 66 20 69 6e  ox/sidebar if in
10e0: 20 62 6f 78 2f 73 69 64 65 62 61 72 20 6d 6f 64   box/sidebar mod
10f0: 65 2c 20 74 68 65 6e 20 69 6e 76 6f 6b 65 64 20  e, then invoked 
1100: 73 74 61 6e 64 61 72 64 0a 2e 5c 22 09 23 20 70  standard..\".# p
1110: 61 67 65 20 62 6f 74 74 6f 6d 20 6d 61 63 72 6f  age bottom macro
1120: 2e 0a 2e 64 65 20 5e 42 0a 2e 65 76 20 32 0a 27  ...de ^B..ev 2.'
1130: 74 69 20 30 0a 27 6e 66 0a 2e 6d 6b 20 5e 74 0a  ti 0.'nf..mk ^t.
1140: 2e 69 66 20 5c 5c 6e 28 5e 62 20 5c 7b 5c 0a 2e  .if \\n(^b \{\..
1150: 5c 22 09 44 72 61 77 20 74 68 72 65 65 2d 73 69  \".Draw three-si
1160: 64 65 64 20 62 6f 78 20 69 66 20 74 68 69 73 20  ded box if this 
1170: 69 73 20 74 68 65 20 62 6f 78 27 73 20 66 69 72  is the box's fir
1180: 73 74 20 70 61 67 65 2c 0a 2e 5c 22 09 64 72 61  st page,..\".dra
1190: 77 20 74 77 6f 20 73 69 64 65 73 20 62 75 74 20  w two sides but 
11a0: 6e 6f 20 74 6f 70 20 6f 74 68 65 72 77 69 73 65  no top otherwise
11b0: 2e 0a 2e 69 65 20 21 5c 5c 6e 28 5e 62 2d 31 20  ...ie !\\n(^b-1 
11c0: 5c 68 27 2d 31 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e  \h'-1.5n'\L'|\\n
11d0: 28 5e 79 75 2d 31 76 27 5c 6c 27 5c 5c 6e 28 5e  (^yu-1v'\l'\\n(^
11e0: 6c 75 2b 33 6e 5c 28 75 6c 27 5c 4c 27 5c 5c 6e  lu+3n\(ul'\L'\\n
11f0: 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27  (^tu+1v-\\n(^yu'
1200: 5c 68 27 7c 30 75 27 5c 63 0a 2e 65 6c 20 5c 68  \h'|0u'\c..el \h
1210: 27 2d 31 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e  '-1.5n'\L'|\\n(^
1220: 79 75 2d 31 76 27 5c 68 27 5c 5c 6e 28 5e 6c 75  yu-1v'\h'\\n(^lu
1230: 2b 33 6e 27 5c 4c 27 5c 5c 6e 28 5e 74 75 2b 31  +3n'\L'\\n(^tu+1
1240: 76 2d 5c 5c 6e 28 5e 79 75 27 5c 68 27 7c 30 75  v-\\n(^yu'\h'|0u
1250: 27 5c 63 0a 2e 5c 7d 0a 2e 69 66 20 5c 5c 6e 28  '\c..\}..if \\n(
1260: 5e 76 20 5c 7b 5c 0a 2e 6e 72 20 5e 78 20 5c 5c  ^v \{\..nr ^x \\
1270: 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 59 75  n(^tu+1v-\\n(^Yu
1280: 0a 5c 6b 78 5c 68 27 2d 5c 5c 6e 78 75 27 5c 68  .\kx\h'-\\nxu'\h
1290: 27 7c 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 5c 6b 79  '|\\n(^lu+3n'\ky
12a0: 5c 4c 27 2d 5c 5c 6e 28 5e 78 75 27 5c 76 27 5c  \L'-\\n(^xu'\v'\
12b0: 5c 6e 28 5e 78 75 27 5c 68 27 7c 30 75 27 5c 63  \n(^xu'\h'|0u'\c
12c0: 0a 2e 5c 7d 0a 2e 62 70 0a 27 66 69 0a 2e 65 76  ..\}..bp.'fi..ev
12d0: 0a 2e 69 66 20 5c 5c 6e 28 5e 62 20 5c 7b 5c 0a  ..if \\n(^b \{\.
12e0: 2e 6d 6b 20 5e 79 0a 2e 6e 72 20 5e 62 20 32 0a  .mk ^y..nr ^b 2.
12f0: 2e 5c 7d 0a 2e 69 66 20 5c 5c 6e 28 5e 76 20 5c  .\}..if \\n(^v \
1300: 7b 5c 0a 2e 6d 6b 20 5e 59 0a 2e 5c 7d 0a 2e 2e  {\..mk ^Y..\}...
1310: 0a 2e 5c 22 09 23 20 44 53 20 2d 20 62 65 67 69  ..\".# DS - begi
1320: 6e 20 64 69 73 70 6c 61 79 0a 2e 64 65 20 44 53  n display..de DS
1330: 0a 2e 52 53 0a 2e 6e 66 0a 2e 73 70 0a 2e 2e 0a  ..RS..nf..sp....
1340: 2e 5c 22 09 23 20 44 45 20 2d 20 65 6e 64 20 64  .\".# DE - end d
1350: 69 73 70 6c 61 79 0a 2e 64 65 20 44 45 0a 2e 66  isplay..de DE..f
1360: 69 0a 2e 52 45 0a 2e 73 70 0a 2e 2e 0a 2e 5c 22  i..RE..sp.....\"
1370: 09 23 20 53 4f 20 2d 20 73 74 61 72 74 20 6f 66  .# SO - start of
1380: 20 6c 69 73 74 20 6f 66 20 73 74 61 6e 64 61 72   list of standar
1390: 64 20 6f 70 74 69 6f 6e 73 0a 2e 64 65 20 53 4f  d options..de SO
13a0: 0a 27 69 65 20 27 5c 5c 24 31 27 27 20 2e 64 73  .'ie '\\$1'' .ds
13b0: 20 53 6f 20 5c 5c 66 42 6f 70 74 69 6f 6e 73 5c   So \\fBoptions\
13c0: 5c 66 52 0a 27 65 6c 20 2e 64 73 20 53 6f 20 5c  \fR.'el .ds So \
13d0: 5c 66 42 5c 5c 24 31 5c 5c 66 52 0a 2e 53 48 20  \fB\\$1\\fR..SH 
13e0: 22 53 54 41 4e 44 41 52 44 20 4f 50 54 49 4f 4e  "STANDARD OPTION
13f0: 53 22 0a 2e 4c 50 0a 2e 6e 66 0a 2e 74 61 20 35  S"..LP..nf..ta 5
1400: 2e 35 63 20 31 31 63 0a 2e 66 74 20 42 0a 2e 2e  .5c 11c..ft B...
1410: 0a 2e 5c 22 09 23 20 53 45 20 2d 20 65 6e 64 20  ..\".# SE - end 
1420: 6f 66 20 6c 69 73 74 20 6f 66 20 73 74 61 6e 64  of list of stand
1430: 61 72 64 20 6f 70 74 69 6f 6e 73 0a 2e 64 65 20  ard options..de 
1440: 53 45 0a 2e 66 69 0a 2e 66 74 20 52 0a 2e 4c 50  SE..fi..ft R..LP
1450: 0a 53 65 65 20 74 68 65 20 5c 5c 2a 28 53 6f 20  .See the \\*(So 
1460: 6d 61 6e 75 61 6c 20 65 6e 74 72 79 20 66 6f 72  manual entry for
1470: 20 64 65 74 61 69 6c 73 20 6f 6e 20 74 68 65 20   details on the 
1480: 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73  standard options
1490: 2e 0a 2e 2e 0a 2e 5c 22 09 23 20 4f 50 20 2d 20  ......\".# OP - 
14a0: 73 74 61 72 74 20 6f 66 20 66 75 6c 6c 20 64 65  start of full de
14b0: 73 63 72 69 70 74 69 6f 6e 20 66 6f 72 20 61 20  scription for a 
14c0: 73 69 6e 67 6c 65 20 6f 70 74 69 6f 6e 0a 2e 64  single option..d
14d0: 65 20 4f 50 0a 2e 4c 50 0a 2e 6e 66 0a 2e 74 61  e OP..LP..nf..ta
14e0: 20 34 63 0a 43 6f 6d 6d 61 6e 64 2d 4c 69 6e 65   4c.Command-Line
14f0: 20 4e 61 6d 65 3a 09 5c 5c 66 42 5c 5c 24 31 5c   Name:.\\fB\\$1\
1500: 5c 66 52 0a 44 61 74 61 62 61 73 65 20 4e 61 6d  \fR.Database Nam
1510: 65 3a 09 5c 5c 66 42 5c 5c 24 32 5c 5c 66 52 0a  e:.\\fB\\$2\\fR.
1520: 44 61 74 61 62 61 73 65 20 43 6c 61 73 73 3a 09  Database Class:.
1530: 5c 5c 66 42 5c 5c 24 33 5c 5c 66 52 0a 2e 66 69  \\fB\\$3\\fR..fi
1540: 0a 2e 49 50 0a 2e 2e 0a 2e 5c 22 09 23 20 43 53  ..IP.....\".# CS
1550: 20 2d 20 62 65 67 69 6e 20 63 6f 64 65 20 65 78   - begin code ex
1560: 63 65 72 70 74 0a 2e 64 65 20 43 53 0a 2e 52 53  cerpt..de CS..RS
1570: 0a 2e 6e 66 0a 2e 74 61 20 2e 32 35 69 20 2e 35  ..nf..ta .25i .5
1580: 69 20 2e 37 35 69 20 31 69 0a 2e 2e 0a 2e 5c 22  i .75i 1i.....\"
1590: 09 23 20 43 45 20 2d 20 65 6e 64 20 63 6f 64 65  .# CE - end code
15a0: 20 65 78 63 65 72 70 74 0a 2e 64 65 20 43 45 0a   excerpt..de CE.
15b0: 2e 66 69 0a 2e 52 45 0a 2e 2e 0a 2e 5c 22 09 23  .fi..RE.....\".#
15c0: 20 55 4c 20 2d 20 75 6e 64 65 72 6c 69 6e 65 20   UL - underline 
15d0: 77 6f 72 64 0a 2e 64 65 20 55 4c 0a 5c 5c 24 31  word..de UL.\\$1
15e0: 5c 6c 27 7c 30 5c 28 75 6c 27 5c 5c 24 32 0a 2e  \l'|0\(ul'\\$2..
15f0: 2e 0a 2e 5c 22 09 23 20 51 57 20 2d 20 61 70 70  ...\".# QW - app
1600: 6c 79 20 71 75 6f 74 61 74 69 6f 6e 20 6d 61 72  ly quotation mar
1610: 6b 73 20 74 6f 20 77 6f 72 64 0a 2e 64 65 20 51  ks to word..de Q
1620: 57 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 27 22 27  W..ie '\\*(lq'"'
1630: 20 60 60 5c 5c 24 31 27 27 5c 5c 24 32 0a 2e 5c   ``\\$1''\\$2..\
1640: 22 22 20 66 69 78 20 65 6d 61 63 73 20 68 69 67  "" fix emacs hig
1650: 68 6c 69 67 68 74 69 6e 67 0a 2e 65 6c 20 5c 5c  hlighting..el \\
1660: 2a 28 6c 71 5c 5c 24 31 5c 5c 2a 28 72 71 5c 5c  *(lq\\$1\\*(rq\\
1670: 24 32 0a 2e 2e 0a 2e 5c 22 09 23 20 50 51 20 2d  $2.....\".# PQ -
1680: 20 61 70 70 6c 79 20 70 61 72 65 6e 73 20 61 6e   apply parens an
1690: 64 20 71 75 6f 74 61 74 69 6f 6e 20 6d 61 72 6b  d quotation mark
16a0: 73 20 74 6f 20 77 6f 72 64 0a 2e 64 65 20 50 51  s to word..de PQ
16b0: 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 27 22 27 20  ..ie '\\*(lq'"' 
16c0: 28 60 60 5c 5c 24 31 27 27 5c 5c 24 32 29 5c 5c  (``\\$1''\\$2)\\
16d0: 24 33 0a 2e 5c 22 22 20 66 69 78 20 65 6d 61 63  $3..\"" fix emac
16e0: 73 20 68 69 67 68 6c 69 67 68 74 69 6e 67 0a 2e  s highlighting..
16f0: 65 6c 20 28 5c 5c 2a 28 6c 71 5c 5c 24 31 5c 5c  el (\\*(lq\\$1\\
1700: 2a 28 72 71 5c 5c 24 32 29 5c 5c 24 33 0a 2e 2e  *(rq\\$2)\\$3...
1710: 0a 2e 5c 22 09 23 20 51 52 20 2d 20 71 75 6f 74  ..\".# QR - quot
1720: 65 64 20 72 61 6e 67 65 0a 2e 64 65 20 51 52 0a  ed range..de QR.
1730: 2e 69 65 20 27 5c 5c 2a 28 6c 71 27 22 27 20 60  .ie '\\*(lq'"' `
1740: 60 5c 5c 24 31 27 27 5c 5c 2d 60 60 5c 5c 24 32  `\\$1''\\-``\\$2
1750: 27 27 5c 5c 24 33 0a 2e 5c 22 22 20 66 69 78 20  ''\\$3..\"" fix 
1760: 65 6d 61 63 73 20 68 69 67 68 6c 69 67 68 74 69  emacs highlighti
1770: 6e 67 0a 2e 65 6c 20 5c 5c 2a 28 6c 71 5c 5c 24  ng..el \\*(lq\\$
1780: 31 5c 5c 2a 28 72 71 5c 5c 2d 5c 5c 2a 28 6c 71  1\\*(rq\\-\\*(lq
1790: 5c 5c 24 32 5c 5c 2a 28 72 71 5c 5c 24 33 0a 2e  \\$2\\*(rq\\$3..
17a0: 2e 0a 2e 5c 22 09 23 20 4d 54 20 2d 20 22 65 6d  ...\".# MT - "em
17b0: 70 74 79 22 20 73 74 72 69 6e 67 0a 2e 64 65 20  pty" string..de 
17c0: 4d 54 0a 2e 51 57 20 22 22 0a 2e 2e 0a 2e 42 53  MT..QW "".....BS
17d0: 0a 2e 53 48 20 4e 41 4d 45 0a 63 6d 64 72 3a 3a  ..SH NAME.cmdr::
17e0: 63 6f 6e 66 69 67 20 5c 2d 20 43 6d 64 72 20 2d  config \- Cmdr -
17f0: 20 28 50 61 72 74 69 61 6c 6c 79 20 69 6e 74 65   (Partially inte
1800: 72 6e 61 6c 29 20 43 6f 6c 6c 65 63 74 69 6f 6e  rnal) Collection
1810: 20 6f 66 20 70 61 72 61 6d 65 74 65 72 73 20 66   of parameters f
1820: 6f 72 20 70 72 69 76 61 74 65 73 0a 2e 53 48 20  or privates..SH 
1830: 53 59 4e 4f 50 53 49 53 0a 70 61 63 6b 61 67 65  SYNOPSIS.package
1840: 20 72 65 71 75 69 72 65 20 5c 66 42 63 6d 64 72   require \fBcmdr
1850: 3a 3a 63 6f 6e 66 69 67 20 5c 66 52 0a 2e 73 70  ::config \fR..sp
1860: 0a 5c 66 42 3a 3a 63 6d 64 72 3a 3a 63 6f 6e 66  .\fB::cmdr::conf
1870: 69 67 5c 66 52 20 5c 66 42 6e 65 77 5c 66 52 20  ig\fR \fBnew\fR 
1880: 5c 66 49 63 6f 6e 74 65 78 74 5c 66 52 20 5c 66  \fIcontext\fR \f
1890: 49 73 70 65 63 5c 66 52 0a 2e 73 70 0a 5c 66 42  Ispec\fR..sp.\fB
18a0: 3a 3a 63 6d 64 72 3a 3a 63 6f 6e 66 69 67 5c 66  ::cmdr::config\f
18b0: 52 20 5c 66 42 63 72 65 61 74 65 5c 66 52 20 5c  R \fBcreate\fR \
18c0: 66 49 6f 62 6a 5c 66 52 20 5c 66 49 63 6f 6e 74  fIobj\fR \fIcont
18d0: 65 78 74 5c 66 52 20 5c 66 49 73 70 65 63 5c 66  ext\fR \fIspec\f
18e0: 52 0a 2e 73 70 0a 5c 66 42 3a 3a 63 6d 64 72 3a  R..sp.\fB::cmdr:
18f0: 3a 63 6f 6e 66 69 67 5c 66 52 20 5c 66 42 69 6e  :config\fR \fBin
1900: 74 65 72 61 63 74 69 76 65 5c 66 52 20 3f 5c 66  teractive\fR ?\f
1910: 49 65 6e 61 62 6c 65 5c 66 52 3f 0a 2e 73 70 0a  Ienable\fR?..sp.
1920: 5c 66 42 3a 3a 63 6d 64 72 3a 3a 63 6f 6e 66 69  \fB::cmdr::confi
1930: 67 5c 66 52 20 5c 66 42 64 69 73 70 6c 61 79 5c  g\fR \fBdisplay\
1940: 66 52 20 5c 66 49 64 69 73 70 6c 61 79 63 6d 64  fR \fIdisplaycmd
1950: 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66  \fR..sp.\fB<conf
1960: 69 67 3e 5c 66 52 20 5c 66 42 40 5c 26 2e 5c 26  ig>\fR \fB@\&.\&
1970: 2e 5c 26 2e 5c 66 52 20 5c 66 49 5c 26 2e 5c 26  .\&.\fR \fI\&.\&
1980: 2e 5c 26 2e 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c  .\&.\fR..sp.\fB<
1990: 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 61 72  config>\fR \fBar
19a0: 67 75 6d 65 6e 74 73 5c 66 52 0a 2e 73 70 0a 5c  guments\fR..sp.\
19b0: 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66  fB<config>\fR \f
19c0: 42 63 6f 6d 70 6c 65 74 65 5c 66 52 20 5c 66 49  Bcomplete\fR \fI
19d0: 6c 69 6e 65 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c  line\fR..sp.\fB<
19e0: 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 63 6f  config>\fR \fBco
19f0: 6d 70 6c 65 74 65 2d 72 65 70 6c 5c 66 52 20 5c  mplete-repl\fR \
1a00: 66 49 70 61 72 73 65 5c 66 52 0a 2e 73 70 0a 5c  fIparse\fR..sp.\
1a10: 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66  fB<config>\fR \f
1a20: 42 63 6f 6d 70 6c 65 74 65 2d 77 6f 72 64 73 5c  Bcomplete-words\
1a30: 66 52 20 5c 66 49 70 61 72 73 65 5c 66 52 0a 2e  fR \fIparse\fR..
1a40: 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66  sp.\fB<config>\f
1a50: 52 20 5c 66 42 63 6f 6e 74 69 6e 75 65 64 5c 66  R \fBcontinued\f
1a60: 52 20 5c 66 49 6c 69 6e 65 5c 66 52 0a 2e 73 70  R \fIline\fR..sp
1a70: 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20  .\fB<config>\fR 
1a80: 5c 66 42 64 69 73 70 61 74 63 68 5c 66 52 20 5c  \fBdispatch\fR \
1a90: 66 49 63 6d 64 5c 66 52 0a 2e 73 70 0a 5c 66 42  fIcmd\fR..sp.\fB
1aa0: 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 64  <config>\fR \fBd
1ab0: 69 73 70 6c 61 79 5c 66 52 20 3f 5c 66 49 70 6c  isplay\fR ?\fIpl
1ac0: 69 73 74 5c 66 52 3f 0a 2e 73 70 0a 5c 66 42 3c  ist\fR?..sp.\fB<
1ad0: 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 64 75  config>\fR \fBdu
1ae0: 6d 70 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c 63 6f  mp\fR..sp.\fB<co
1af0: 6e 66 69 67 3e 5c 66 52 20 5c 66 42 65 6f 70 74  nfig>\fR \fBeopt
1b00: 69 6f 6e 73 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c  ions\fR..sp.\fB<
1b10: 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 65 78  config>\fR \fBex
1b20: 69 74 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c 63 6f  it\fR..sp.\fB<co
1b30: 6e 66 69 67 3e 5c 66 52 20 5c 66 42 66 6f 72 63  nfig>\fR \fBforc
1b40: 65 5c 66 52 20 3f 5c 66 49 61 6c 6c 6f 77 69 6e  e\fR ?\fIallowin
1b50: 74 65 72 61 63 74 5c 66 52 3f 20 3f 5c 66 49 66  teract\fR? ?\fIf
1b60: 6f 72 63 65 64 65 66 65 72 65 64 5c 66 52 3f 0a  orcedefered\fR?.
1b70: 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c  .sp.\fB<config>\
1b80: 66 52 20 5c 66 42 66 6f 72 67 65 74 5c 66 52 0a  fR \fBforget\fR.
1b90: 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c  .sp.\fB<config>\
1ba0: 66 52 20 5c 66 42 68 61 73 5c 66 52 20 5c 66 49  fR \fBhas\fR \fI
1bb0: 6e 61 6d 65 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c  name\fR..sp.\fB<
1bc0: 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 68 65  config>\fR \fBhe
1bd0: 6c 70 5c 66 52 20 3f 5c 66 49 6d 6f 64 65 5c 66  lp\fR ?\fImode\f
1be0: 52 3f 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66 69  R?..sp.\fB<confi
1bf0: 67 3e 5c 66 52 20 5c 66 42 69 6e 74 65 72 61 63  g>\fR \fBinterac
1c00: 74 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e  t\fR..sp.\fB<con
1c10: 66 69 67 3e 5c 66 52 20 5c 66 42 69 6e 74 65 72  fig>\fR \fBinter
1c20: 61 63 74 69 76 65 5c 66 52 0a 2e 73 70 0a 5c 66  active\fR..sp.\f
1c30: 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42  B<config>\fR \fB
1c40: 6c 6f 6f 6b 75 70 5c 66 52 20 5c 66 49 6e 61 6d  lookup\fR \fInam
1c50: 65 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e  e\fR..sp.\fB<con
1c60: 66 69 67 3e 5c 66 52 20 5c 66 42 6c 6f 6f 6b 75  fig>\fR \fBlooku
1c70: 70 2d 6f 70 74 69 6f 6e 5c 66 52 20 5c 66 49 6e  p-option\fR \fIn
1c80: 61 6d 65 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c 63  ame\fR..sp.\fB<c
1c90: 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 6d 69 73  onfig>\fR \fBmis
1ca0: 73 69 6e 67 4f 70 74 69 6f 6e 56 61 6c 75 65 5c  singOptionValue\
1cb0: 66 52 20 5c 66 49 6e 61 6d 65 5c 66 52 0a 2e 73  fR \fIname\fR..s
1cc0: 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52  p.\fB<config>\fR
1cd0: 20 5c 66 42 6e 61 6d 65 73 5c 66 52 0a 2e 73 70   \fBnames\fR..sp
1ce0: 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20  .\fB<config>\fR 
1cf0: 5c 66 42 6e 6f 74 45 6e 6f 75 67 68 5c 66 52 0a  \fBnotEnough\fR.
1d00: 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c  .sp.\fB<config>\
1d10: 66 52 20 5c 66 42 6f 70 74 69 6f 6e 73 5c 66 52  fR \fBoptions\fR
1d20: 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e  ..sp.\fB<config>
1d30: 5c 66 52 20 5c 66 42 70 61 72 73 65 5c 66 52 20  \fR \fBparse\fR 
1d40: 3f 5c 66 49 77 6f 72 64 5c 26 2e 5c 26 2e 5c 26  ?\fIword\&.\&.\&
1d50: 2e 5c 66 52 3f 0a 2e 73 70 0a 5c 66 42 3c 63 6f  .\fR?..sp.\fB<co
1d60: 6e 66 69 67 3e 5c 66 52 20 5c 66 42 70 61 72 73  nfig>\fR \fBpars
1d70: 65 2d 6f 70 74 69 6f 6e 73 5c 66 52 0a 2e 73 70  e-options\fR..sp
1d80: 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20  .\fB<config>\fR 
1d90: 5c 66 42 70 72 6f 6d 70 74 31 5c 66 52 0a 2e 73  \fBprompt1\fR..s
1da0: 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52  p.\fB<config>\fR
1db0: 20 5c 66 42 70 72 6f 6d 70 74 32 5c 66 52 0a 2e   \fBprompt2\fR..
1dc0: 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66  sp.\fB<config>\f
1dd0: 52 20 5c 66 42 70 75 62 6c 69 63 5c 66 52 0a 2e  R \fBpublic\fR..
1de0: 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66  sp.\fB<config>\f
1df0: 52 20 5c 66 42 72 61 69 73 65 5c 66 52 20 5c 66  R \fBraise\fR \f
1e00: 49 6d 73 67 5c 66 52 20 3f 5c 66 49 77 6f 72 64  Imsg\fR ?\fIword
1e10: 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 0a 2e 73  \&.\&.\&.\fR?..s
1e20: 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52  p.\fB<config>\fR
1e30: 20 5c 66 42 72 65 70 6f 72 74 5c 66 52 20 5c 66   \fBreport\fR \f
1e40: 49 77 68 61 74 5c 66 52 20 5c 66 49 64 61 74 61  Iwhat\fR \fIdata
1e50: 5c 66 52 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66  \fR..sp.\fB<conf
1e60: 69 67 3e 5c 66 52 20 5c 66 42 72 65 73 65 74 5c  ig>\fR \fBreset\
1e70: 66 52 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66 69  fR..sp.\fB<confi
1e80: 67 3e 5c 66 52 20 5c 66 42 73 65 6c 66 5c 66 52  g>\fR \fBself\fR
1e90: 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e  ..sp.\fB<config>
1ea0: 5c 66 52 20 5c 66 42 74 6f 6f 4d 61 6e 79 5c 66  \fR \fBtooMany\f
1eb0: 52 0a 2e 73 70 0a 5c 66 42 3c 63 6f 6e 66 69 67  R..sp.\fB<config
1ec0: 3e 5c 66 52 20 5c 66 42 75 6e 6b 6e 6f 77 6e 5c  >\fR \fBunknown\
1ed0: 66 52 20 5c 66 49 6d 65 74 68 6f 64 5c 66 52 20  fR \fImethod\fR 
1ee0: 3f 5c 66 49 77 6f 72 64 5c 26 2e 5c 26 2e 5c 26  ?\fIword\&.\&.\&
1ef0: 2e 5c 66 52 3f 0a 2e 73 70 0a 2e 42 45 0a 2e 53  .\fR?..sp..BE..S
1f00: 48 20 44 45 53 43 52 49 50 54 49 4f 4e 0a 2e 50  H DESCRIPTION..P
1f10: 50 0a 57 65 6c 63 6f 6d 65 20 74 6f 20 74 68 65  P.Welcome to the
1f20: 20 43 6d 64 72 20 70 72 6f 6a 65 63 74 2c 20 77   Cmdr project, w
1f30: 72 69 74 74 65 6e 20 62 79 20 41 6e 64 72 65 61  ritten by Andrea
1f40: 73 20 4b 75 70 72 69 65 73 5c 26 2e 0a 2e 50 50  s Kupries\&...PP
1f50: 0a 46 6f 72 20 61 76 61 69 6c 61 62 69 6c 69 74  .For availabilit
1f60: 79 20 70 6c 65 61 73 65 20 72 65 61 64 20 5c 66  y please read \f
1f70: 49 43 6d 64 72 20 2d 20 48 6f 77 20 54 6f 20 47  ICmdr - How To G
1f80: 65 74 20 54 68 65 20 53 6f 75 72 63 65 73 5c 66  et The Sources\f
1f90: 52 5c 26 2e 0a 2e 50 50 0a 54 68 69 73 20 70 61  R\&...PP.This pa
1fa0: 63 6b 61 67 65 20 69 6d 70 6c 65 6d 65 6e 74 73  ckage implements
1fb0: 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e 73   the collections
1fc0: 20 6f 66 20 5c 66 42 63 6d 64 72 3a 3a 70 61 72   of \fBcmdr::par
1fd0: 61 6d 65 74 65 72 73 5c 66 52 0a 73 65 72 76 69  ameters\fR.servi
1fe0: 6e 67 20 61 73 20 74 68 65 20 63 6f 6e 66 69 67  ng as the config
1ff0: 75 72 61 74 69 6f 6e 20 6f 66 20 70 72 69 76 61  uration of priva
2000: 74 65 73 20 28 73 65 65 20 5c 66 42 63 6d 64 72  tes (see \fBcmdr
2010: 3a 3a 70 72 69 76 61 74 65 5c 66 52 29 5c 26 2e  ::private\fR)\&.
2020: 0a 2e 53 48 20 22 43 4c 41 53 53 20 41 50 49 22  ..SH "CLASS API"
2030: 0a 54 68 65 20 63 6c 61 73 73 20 41 50 49 20 69  .The class API i
2040: 73 20 6e 6f 74 20 70 75 62 6c 69 63 5c 26 2e 20  s not public\&. 
2050: 49 74 20 69 73 20 75 73 65 64 20 69 6e 74 65 72  It is used inter
2060: 6e 61 6c 6c 79 20 62 79 20 74 68 65 20 66 72 61  nally by the fra
2070: 6d 65 77 6f 72 6b 0a 77 68 65 6e 20 70 61 72 73  mework.when pars
2080: 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 68 69  ing a command hi
2090: 65 72 61 72 63 68 79 20 73 70 65 63 69 66 69 63  erarchy specific
20a0: 61 74 69 6f 6e 20 74 6f 20 63 72 65 61 74 65 20  ation to create 
20b0: 74 68 65 20 6e 65 63 65 73 73 61 72 79 0a 63 6f  the necessary.co
20c0: 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 6e 73 74  nfiguration inst
20d0: 61 6e 63 65 73 5c 26 2e 0a 2e 50 50 0a 49 74 20  ances\&...PP.It 
20e0: 69 73 20 64 65 73 63 72 69 62 65 64 20 68 65 72  is described her
20f0: 65 20 66 6f 72 20 75 73 65 20 62 79 20 64 65 76  e for use by dev
2100: 65 6c 6f 70 65 72 73 20 6d 61 69 6e 74 61 69 6e  elopers maintain
2110: 69 6e 67 2c 0a 6d 6f 64 69 66 79 69 6e 67 20 61  ing,.modifying a
2120: 6e 64 20 65 78 74 65 6e 64 69 6e 67 20 74 68 65  nd extending the
2130: 20 66 72 61 6d 65 77 6f 72 6b 20 69 74 73 65 6c   framework itsel
2140: 66 5c 26 2e 20 41 20 75 73 65 72 20 6f 66 20 74  f\&. A user of t
2150: 68 65 20 66 72 61 6d 65 77 6f 72 6b 0a 68 61 73  he framework.has
2160: 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 69 74 5c   no need for it\
2170: 26 2e 0a 2e 54 50 0a 5c 66 42 3a 3a 63 6d 64 72  &...TP.\fB::cmdr
2180: 3a 3a 63 6f 6e 66 69 67 5c 66 52 20 5c 66 42 6e  ::config\fR \fBn
2190: 65 77 5c 66 52 20 5c 66 49 63 6f 6e 74 65 78 74  ew\fR \fIcontext
21a0: 5c 66 52 20 5c 66 49 73 70 65 63 5c 66 52 0a 43  \fR \fIspec\fR.C
21b0: 72 65 61 74 65 20 61 6e 20 61 75 74 6f 2d 6e 61  reate an auto-na
21c0: 6d 65 64 20 69 6e 73 74 61 6e 63 65 20 6f 66 20  med instance of 
21d0: 5c 66 42 63 6d 64 72 3a 3a 63 6f 6e 66 69 67 5c  \fBcmdr::config\
21e0: 66 52 5c 26 2e 0a 2e 73 70 0a 5c 66 49 4e 6f 74  fR\&...sp.\fINot
21f0: 20 75 73 65 64 5c 66 52 5c 26 2e 0a 2e 54 50 0a   used\fR\&...TP.
2200: 5c 66 42 3a 3a 63 6d 64 72 3a 3a 63 6f 6e 66 69  \fB::cmdr::confi
2210: 67 5c 66 52 20 5c 66 42 63 72 65 61 74 65 5c 66  g\fR \fBcreate\f
2220: 52 20 5c 66 49 6f 62 6a 5c 66 52 20 5c 66 49 63  R \fIobj\fR \fIc
2230: 6f 6e 74 65 78 74 5c 66 52 20 5c 66 49 73 70 65  ontext\fR \fIspe
2240: 63 5c 66 52 0a 43 72 65 61 74 65 20 61 20 6e 65  c\fR.Create a ne
2250: 77 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 5c 66  w instance of \f
2260: 42 63 6d 64 72 3a 3a 63 6f 6e 66 69 67 5c 66 52  Bcmdr::config\fR
2270: 2c 20 6e 61 6d 65 64 20 5c 66 49 6f 62 6a 5c 66  , named \fIobj\f
2280: 52 5c 26 2e 0a 2e 52 53 0a 2e 54 50 0a 73 74 72  R\&...RS..TP.str
2290: 69 6e 67 20 5c 66 49 6f 62 6a 5c 66 52 0a 54 68  ing \fIobj\fR.Th
22a0: 65 20 28 63 6f 6d 6d 61 6e 64 29 20 6e 61 6d 65  e (command) name
22b0: 20 6f 66 20 74 68 65 20 6e 65 77 20 63 6f 6e 66   of the new conf
22c0: 69 67 20 69 6e 73 74 61 6e 63 65 5c 26 2e 0a 2e  ig instance\&...
22d0: 54 50 0a 63 6d 64 72 3a 3a 63 6f 6e 66 69 67 20  TP.cmdr::config 
22e0: 5c 66 49 63 6f 6e 74 65 78 74 5c 66 52 0a 54 68  \fIcontext\fR.Th
22f0: 65 20 69 6e 73 74 61 6e 63 65 20 63 6f 6d 6d 61  e instance comma
2300: 6e 64 20 6f 66 20 74 68 65 20 5c 66 42 63 6d 64  nd of the \fBcmd
2310: 72 3a 3a 70 72 69 76 61 74 65 5c 66 52 20 69 6e  r::private\fR in
2320: 73 74 61 6e 63 65 20 74 68 65 20 63 6f 6e 66 69  stance the confi
2330: 67 75 72 61 74 69 6f 6e 0a 77 69 6c 6c 20 62 65  guration.will be
2340: 6c 6f 6e 67 20 74 6f 5c 26 2e 0a 2e 54 50 0a 73  long to\&...TP.s
2350: 63 72 69 70 74 20 5c 66 49 73 70 65 63 5c 66 52  cript \fIspec\fR
2360: 0a 54 63 6c 2d 73 63 72 69 70 74 20 73 70 65 63  .Tcl-script spec
2370: 69 66 79 69 6e 67 20 74 68 65 20 70 61 72 61 6d  ifying the param
2380: 65 74 65 72 73 20 69 6e 20 64 65 74 61 69 6c 5c  eters in detail\
2390: 26 2e 0a 50 6c 65 61 73 65 20 72 65 61 64 20 5c  &..Please read \
23a0: 66 49 43 6d 64 72 20 2d 20 50 61 72 61 6d 65 74  fICmdr - Paramet
23b0: 65 72 20 53 70 65 63 69 66 69 63 61 74 69 6f 6e  er Specification
23c0: 20 4c 61 6e 67 75 61 67 65 5c 66 52 20 66 6f 72   Language\fR for
23d0: 20 74 68 65 20 64 65 74 61 69 6c 73 5c 26 2e 0a   the details\&..
23e0: 2e 52 45 0a 2e 54 50 0a 5c 66 42 3a 3a 63 6d 64  .RE..TP.\fB::cmd
23f0: 72 3a 3a 63 6f 6e 66 69 67 5c 66 52 20 5c 66 42  r::config\fR \fB
2400: 69 6e 74 65 72 61 63 74 69 76 65 5c 66 52 20 3f  interactive\fR ?
2410: 5c 66 49 65 6e 61 62 6c 65 5c 66 52 3f 0a 43 6c  \fIenable\fR?.Cl
2420: 61 73 73 20 6d 65 74 68 6f 64 20 74 6f 20 63 68  ass method to ch
2430: 61 6e 67 65 20 74 68 65 20 67 6c 6f 62 61 6c 20  ange the global 
2440: 69 6e 74 65 72 61 63 74 69 6f 6e 20 64 65 66 61  interaction defa
2450: 75 6c 74 20 66 6f 72 20 74 68 65 0a 6d 69 6e 69  ult for the.mini
2460: 2d 73 68 65 6c 6c 20 6f 66 20 70 72 69 76 61 74  -shell of privat
2470: 65 73 5c 26 2e 20 54 68 65 20 64 65 66 61 75 6c  es\&. The defaul
2480: 74 20 69 73 20 74 6f 20 64 69 73 61 62 6c 65 20  t is to disable 
2490: 74 68 69 73 20 6d 69 6e 69 2d 73 68 65 6c 6c 0a  this mini-shell.
24a0: 66 6f 72 20 61 6c 6c 20 70 72 69 76 61 74 65 73  for all privates
24b0: 2c 20 61 6e 64 20 65 6e 61 62 6c 65 20 69 74 20  , and enable it 
24c0: 6f 6e 20 61 20 70 65 72 2d 70 72 69 76 61 74 65  on a per-private
24d0: 20 62 61 73 69 73 2c 20 74 68 72 6f 75 67 68 0a   basis, through.
24e0: 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69 6f  the specificatio
24f0: 6e 5c 26 2e 0a 2e 52 53 0a 2e 54 50 0a 62 6f 6f  n\&...RS..TP.boo
2500: 6c 65 61 6e 20 5c 66 49 65 6e 61 62 6c 65 5c 66  lean \fIenable\f
2510: 52 0a 44 65 66 61 75 6c 74 73 20 74 6f 20 5c 66  R.Defaults to \f
2520: 42 74 72 75 65 5c 66 52 2c 20 67 6c 6f 62 61 6c  Btrue\fR, global
2530: 6c 79 20 61 63 74 69 76 61 74 69 6e 67 20 74 68  ly activating th
2540: 65 20 6d 69 6e 69 2d 73 68 65 6c 6c 5c 26 2e 0a  e mini-shell\&..
2550: 2e 52 45 0a 2e 54 50 0a 5c 66 42 3a 3a 63 6d 64  .RE..TP.\fB::cmd
2560: 72 3a 3a 63 6f 6e 66 69 67 5c 66 52 20 5c 66 42  r::config\fR \fB
2570: 64 69 73 70 6c 61 79 5c 66 52 20 5c 66 49 64 69  display\fR \fIdi
2580: 73 70 6c 61 79 63 6d 64 5c 66 52 0a 43 6c 61 73  splaycmd\fR.Clas
2590: 73 20 6d 65 74 68 6f 64 20 74 6f 20 6f 76 65 72  s method to over
25a0: 72 69 64 65 20 74 68 65 20 73 74 61 6e 64 61 72  ride the standar
25b0: 64 20 64 69 73 70 6c 61 79 20 63 6f 6d 6d 61 6e  d display comman
25c0: 64 20 75 73 65 64 20 62 79 0a 74 68 65 20 6d 69  d used by.the mi
25d0: 6e 69 2d 73 68 65 6c 6c 20 74 6f 20 73 68 6f 77  ni-shell to show
25e0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 74 61   the current sta
25f0: 74 65 20 6f 66 20 61 6c 6c 20 70 61 72 61 6d 65  te of all parame
2600: 74 65 72 73 5c 26 2e 0a 2e 52 53 0a 2e 54 50 0a  ters\&...RS..TP.
2610: 63 6f 6d 6d 61 6e 64 70 72 65 66 69 78 20 5c 66  commandprefix \f
2620: 49 64 69 73 70 6c 61 79 63 6d 64 5c 66 52 0a 54  Idisplaycmd\fR.T
2630: 68 65 20 64 69 73 70 6c 61 79 20 63 6f 6d 6d 61  he display comma
2640: 6e 64 20 74 6f 20 75 73 65 5c 26 2e 20 54 68 65  nd to use\&. The
2650: 20 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 62 65   command will be
2660: 20 63 61 6c 6c 65 64 20 77 69 74 68 20 61 0a 73   called with a.s
2670: 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74 2c 20  ingle argument, 
2680: 61 20 6c 69 73 74 20 63 6f 6e 74 61 69 6e 69 6e  a list containin
2690: 67 20 74 68 65 20 6e 61 6d 65 73 20 6f 66 20 74  g the names of t
26a0: 68 65 20 70 61 72 61 6d 65 74 65 72 73 0a 74 6f  he parameters.to
26b0: 20 73 68 6f 77 5c 26 2e 20 54 68 65 20 63 6f 6d   show\&. The com
26c0: 6d 61 6e 64 20 68 61 73 20 74 6f 20 66 6f 72 6d  mand has to form
26d0: 61 74 20 74 68 65 20 73 74 61 74 65 20 6f 66 20  at the state of 
26e0: 74 68 65 20 72 65 71 75 65 73 74 65 64 0a 70 61  the requested.pa
26f0: 72 61 6d 65 74 65 72 73 20 61 73 20 61 20 73 74  rameters as a st
2700: 72 69 6e 67 20 61 6e 64 20 72 65 74 75 72 6e 20  ring and return 
2710: 74 68 69 73 20 73 74 72 69 6e 67 20 61 73 20 69  this string as i
2720: 74 73 20 72 65 73 75 6c 74 5c 26 2e 0a 2e 52 45  ts result\&...RE
2730: 0a 2e 50 50 0a 2e 53 48 20 22 49 4e 53 54 41 4e  ..PP..SH "INSTAN
2740: 43 45 20 41 50 49 22 0a 4d 6f 73 74 20 6f 66 20  CE API".Most of 
2750: 74 68 65 20 69 6e 73 74 61 6e 63 65 20 41 50 49  the instance API
2760: 20 69 73 20 6e 6f 74 20 70 75 62 6c 69 63 5c 26   is not public\&
2770: 2e 0a 2e 50 50 0a 49 74 20 69 73 20 64 65 73 63  ...PP.It is desc
2780: 72 69 62 65 64 20 68 65 72 65 20 66 6f 72 20 75  ribed here for u
2790: 73 65 20 62 79 20 64 65 76 65 6c 6f 70 65 72 73  se by developers
27a0: 20 6d 61 69 6e 74 61 69 6e 69 6e 67 2c 0a 6d 6f   maintaining,.mo
27b0: 64 69 66 79 69 6e 67 20 61 6e 64 20 65 78 74 65  difying and exte
27c0: 6e 64 69 6e 67 20 74 68 65 20 66 72 61 6d 65 77  nding the framew
27d0: 6f 72 6b 20 69 74 73 65 6c 66 5c 26 2e 20 41 20  ork itself\&. A 
27e0: 75 73 65 72 20 6f 66 20 74 68 65 20 66 72 61 6d  user of the fram
27f0: 65 77 6f 72 6b 0a 68 61 73 20 6e 6f 20 6e 65 65  ework.has no nee
2800: 64 20 66 6f 72 20 69 74 5c 26 2e 0a 2e 54 50 0a  d for it\&...TP.
2810: 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c  \fB<config>\fR \
2820: 66 42 40 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 20  fB@\&.\&.\&.\fR 
2830: 5c 66 49 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 0a  \fI\&.\&.\&.\fR.
2840: 41 6c 6c 20 70 61 72 61 6d 65 74 65 72 73 20 68  All parameters h
2850: 65 6c 64 20 62 79 20 61 20 63 6f 6e 66 69 67 75  eld by a configu
2860: 72 61 74 69 6f 6e 20 69 6e 73 74 61 6e 63 65 20  ration instance 
2870: 61 72 65 20 61 63 63 65 73 73 69 62 6c 65 0a 74  are accessible.t
2880: 68 72 6f 75 67 68 20 69 74 5c 26 2e 20 54 6f 20  hrough it\&. To 
2890: 74 68 69 73 20 65 6e 64 20 65 61 63 68 20 70 61  this end each pa
28a0: 72 61 6d 65 74 65 72 20 6e 61 6d 65 64 20 5c 66  rameter named \f
28b0: 42 66 6f 6f 5c 66 52 20 68 61 73 20 61 0a 64 79  Bfoo\fR has a.dy
28c0: 6e 61 6d 69 63 61 6c 6c 79 20 63 72 65 61 74 65  namically create
28d0: 64 20 61 63 63 65 73 73 6f 72 20 6d 65 74 68 6f  d accessor metho
28e0: 64 20 5c 66 42 40 66 6f 6f 5c 66 52 20 74 61 6b  d \fB@foo\fR tak
28f0: 69 6e 67 20 74 68 65 0a 6d 65 74 68 6f 64 20 61  ing the.method a
2900: 6e 64 20 69 74 73 20 61 72 67 75 6d 65 6e 74 73  nd its arguments
2910: 20 74 6f 20 61 70 70 6c 79 20 74 6f 20 74 68 65   to apply to the
2920: 20 70 61 72 61 6d 65 74 65 72 20 69 6e 73 74 61   parameter insta
2930: 6e 63 65 5c 26 2e 0a 2e 73 70 0a 49 66 20 6e 6f  nce\&...sp.If no
2940: 20 77 6f 72 64 73 20 61 72 65 20 73 70 65 63 69   words are speci
2950: 66 69 65 64 20 61 74 20 61 6c 6c 20 74 68 65 20  fied at all the 
2960: 73 79 73 74 65 6d 20 64 65 66 61 75 6c 74 73 20  system defaults 
2970: 74 6f 20 74 68 65 0a 61 70 70 6c 69 63 61 74 69  to the.applicati
2980: 6f 6e 20 6f 66 20 69 6e 73 74 61 6e 63 65 20 6d  on of instance m
2990: 65 74 68 6f 64 20 5c 66 42 76 61 6c 75 65 5c 66  ethod \fBvalue\f
29a0: 52 5c 26 2e 0a 2e 73 70 0a 54 6f 67 65 74 68 65  R\&...sp.Togethe
29b0: 72 20 77 69 74 68 20 61 20 70 61 72 61 6d 65 74  r with a paramet
29c0: 65 72 27 73 20 61 62 69 6c 69 74 79 20 74 6f 20  er's ability to 
29d0: 61 63 63 65 73 73 20 74 68 65 0a 63 6f 6e 66 69  access the.confi
29e0: 67 75 72 61 74 69 6f 6e 20 68 6f 6c 64 69 6e 67  guration holding
29f0: 20 69 74 20 68 61 76 69 6e 67 20 61 63 63 65 73   it having acces
2a00: 73 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 70 61  s to a single pa
2a10: 72 61 6d 65 74 65 72 0a 69 6e 73 74 61 6e 63 65  rameter.instance
2a20: 20 28 6c 69 6b 65 20 69 6e 20 74 68 65 20 76 61   (like in the va
2a30: 72 69 6f 75 73 20 63 61 6c 6c 62 61 63 6b 73 29  rious callbacks)
2a40: 20 70 72 6f 76 69 64 65 73 20 61 63 63 65 73 73   provides access
2a50: 20 74 6f 20 61 6c 6c 5c 26 2e 0a 2e 52 53 0a 2e   to all\&...RS..
2a60: 54 50 0a 6c 69 73 74 20 5c 66 49 6c 69 73 74 5c  TP.list \fIlist\
2a70: 66 52 0a 2e 52 45 0a 2e 54 50 0a 5c 66 42 3c 63  fR..RE..TP.\fB<c
2a80: 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 61 72 67  onfig>\fR \fBarg
2a90: 75 6d 65 6e 74 73 5c 66 52 0a 54 68 69 73 20 6d  uments\fR.This m
2aa0: 65 74 68 6f 64 20 72 65 74 75 72 6e 73 20 61 20  ethod returns a 
2ab0: 6c 69 73 74 20 6f 66 20 70 61 72 61 6d 65 74 65  list of paramete
2ac0: 72 20 6e 61 6d 65 73 2c 0a 66 6f 72 20 74 68 65  r names,.for the
2ad0: 20 70 61 72 61 6d 65 74 65 72 73 20 77 68 69 63   parameters whic
2ae0: 68 20 61 72 65 20 61 72 67 75 6d 65 6e 74 73 5c  h are arguments\
2af0: 26 2e 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66 69  &...TP.\fB<confi
2b00: 67 3e 5c 66 52 20 5c 66 42 63 6f 6d 70 6c 65 74  g>\fR \fBcomplet
2b10: 65 5c 66 52 20 5c 66 49 6c 69 6e 65 5c 66 52 0a  e\fR \fIline\fR.
2b20: 54 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 70  This method is p
2b30: 61 72 74 20 6f 66 20 74 68 65 20 6d 69 6e 69 20  art of the mini 
2b40: 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 6c 69  shell command li
2b50: 6e 65 0a 63 6f 6d 70 6c 65 74 69 6f 6e 5c 26 2e  ne.completion\&.
2b60: 20 46 6f 72 20 74 68 65 20 64 65 74 61 69 6c 73   For the details
2b70: 20 6f 66 20 69 74 73 20 77 6f 72 6b 69 6e 67 73   of its workings
2b80: 20 70 6c 65 61 73 65 20 72 65 61 64 0a 5c 66 49   please read.\fI
2b90: 43 6d 64 72 20 2d 20 49 6e 74 65 72 6e 61 6c 73  Cmdr - Internals
2ba0: 20 6f 66 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65   of command line
2bb0: 20 63 6f 6d 70 6c 65 74 69 6f 6e 5c 66 52 5c 26   completion\fR\&
2bc0: 2e 0a 2e 73 70 0a 54 68 69 73 20 68 6f 6f 6b 2d  ...sp.This hook-
2bd0: 6d 65 74 68 6f 64 2c 20 74 68 65 20 65 6e 74 72  method, the entr
2be0: 79 70 6f 69 6e 74 20 66 6f 72 20 74 68 65 20 72  ypoint for the r
2bf0: 65 70 6c 0a 69 73 20 72 65 73 70 6f 6e 73 69 62  epl.is responsib
2c00: 6c 65 20 66 6f 72 20 63 6f 6d 70 75 74 69 6e 67  le for computing
2c10: 20 74 68 65 20 73 65 74 20 6f 66 20 63 6f 6d 70   the set of comp
2c20: 6c 65 74 69 6f 6e 73 0a 66 6f 72 20 74 68 65 20  letions.for the 
2c30: 65 6e 74 65 72 65 64 20 5c 66 49 6c 69 6e 65 5c  entered \fIline\
2c40: 66 52 5c 26 2e 0a 2e 52 53 0a 2e 54 50 0a 73 74  fR\&...RS..TP.st
2c50: 72 69 6e 67 20 5c 66 49 6c 69 6e 65 5c 66 52 0a  ring \fIline\fR.
2c60: 54 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65  The command line
2c70: 20 74 6f 20 63 6f 6d 70 6c 65 74 65 5c 26 2e 0a   to complete\&..
2c80: 2e 52 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66  .RE..TP.\fB<conf
2c90: 69 67 3e 5c 66 52 20 5c 66 42 63 6f 6d 70 6c 65  ig>\fR \fBcomple
2ca0: 74 65 2d 72 65 70 6c 5c 66 52 20 5c 66 49 70 61  te-repl\fR \fIpa
2cb0: 72 73 65 5c 66 52 0a 54 68 69 73 20 69 6e 74 65  rse\fR.This inte
2cc0: 72 6e 61 6c 20 6d 65 74 68 6f 64 20 69 73 20 70  rnal method is p
2cd0: 61 72 74 20 6f 66 20 74 68 65 20 6d 69 6e 69 20  art of the mini 
2ce0: 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 6c 69  shell command li
2cf0: 6e 65 0a 63 6f 6d 70 6c 65 74 69 6f 6e 5c 26 2e  ne.completion\&.
2d00: 20 46 6f 72 20 74 68 65 20 64 65 74 61 69 6c 73   For the details
2d10: 20 6f 66 20 69 74 73 20 77 6f 72 6b 69 6e 67 73   of its workings
2d20: 20 70 6c 65 61 73 65 20 72 65 61 64 0a 5c 66 49   please read.\fI
2d30: 43 6d 64 72 20 2d 20 49 6e 74 65 72 6e 61 6c 73  Cmdr - Internals
2d40: 20 6f 66 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65   of command line
2d50: 20 63 6f 6d 70 6c 65 74 69 6f 6e 5c 66 52 5c 26   completion\fR\&
2d60: 2e 0a 2e 73 70 0a 49 74 20 69 73 20 75 73 65 64  ...sp.It is used
2d70: 20 62 79 20 74 68 65 20 68 6f 6f 6b 2d 6d 65 74   by the hook-met
2d80: 68 6f 64 20 5c 66 42 63 6f 6d 70 6c 65 74 65 5c  hod \fBcomplete\
2d90: 66 52 20 28 73 65 65 20 61 62 6f 76 65 29 5c 26  fR (see above)\&
2da0: 2e 0a 47 69 76 65 6e 20 74 68 65 20 63 6f 6d 70  ..Given the comp
2db0: 6c 65 74 69 6f 6e 20 73 74 61 74 65 20 5c 66 49  letion state \fI
2dc0: 70 61 72 73 65 5c 66 52 20 6f 66 20 61 20 70 61  parse\fR of a pa
2dd0: 72 74 69 61 6c 20 63 6f 6d 6d 61 6e 64 0a 6c 69  rtial command.li
2de0: 6e 65 20 69 74 20 72 65 74 75 72 6e 73 20 61 20  ne it returns a 
2df0: 6c 69 73 74 20 6f 66 20 73 74 72 69 6e 67 73 20  list of strings 
2e00: 77 68 69 63 68 20 61 72 65 20 74 68 65 20 76 61  which are the va
2e10: 6c 69 64 0a 63 6f 6d 70 6c 65 74 69 6f 6e 73 20  lid.completions 
2e20: 61 74 20 74 68 69 73 20 70 6f 69 6e 74 5c 26 2e  at this point\&.
2e30: 0a 2e 52 53 0a 2e 54 50 0a 64 69 63 74 20 5c 66  ..RS..TP.dict \f
2e40: 49 70 61 72 73 65 5c 66 52 0a 41 20 64 69 63 74  Iparse\fR.A dict
2e50: 69 6f 6e 61 72 79 20 68 6f 6c 64 69 6e 67 20 74  ionary holding t
2e60: 68 65 20 63 75 72 72 65 6e 74 20 63 6f 6d 70 6c  he current compl
2e70: 65 74 69 6f 6e 20 73 74 61 74 65 20 6f 66 20 61  etion state of a
2e80: 20 70 61 72 74 69 61 6c 20 63 6f 6d 6d 61 6e 64   partial command
2e90: 0a 6c 69 6e 65 5c 26 2e 0a 2e 52 45 0a 2e 54 50  .line\&...RE..TP
2ea0: 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20  .\fB<config>\fR 
2eb0: 5c 66 42 63 6f 6d 70 6c 65 74 65 2d 77 6f 72 64  \fBcomplete-word
2ec0: 73 5c 66 52 20 5c 66 49 70 61 72 73 65 5c 66 52  s\fR \fIparse\fR
2ed0: 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20  .This method is 
2ee0: 70 61 72 74 20 6f 66 20 74 68 65 20 6d 61 69 6e  part of the main
2ef0: 20 73 68 65 6c 6c 20 63 6f 6d 6d 61 6e 64 20 6c   shell command l
2f00: 69 6e 65 0a 63 6f 6d 70 6c 65 74 69 6f 6e 5c 26  ine.completion\&
2f10: 2e 20 46 6f 72 20 74 68 65 20 64 65 74 61 69 6c  . For the detail
2f20: 73 20 6f 66 20 69 74 73 20 77 6f 72 6b 69 6e 67  s of its working
2f30: 73 20 70 6c 65 61 73 65 20 72 65 61 64 0a 5c 66  s please read.\f
2f40: 49 43 6d 64 72 20 2d 20 49 6e 74 65 72 6e 61 6c  ICmdr - Internal
2f50: 73 20 6f 66 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e  s of command lin
2f60: 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 5c 66 52 5c  e completion\fR\
2f70: 26 2e 0a 2e 73 70 0a 47 69 76 65 6e 20 74 68 65  &...sp.Given the
2f80: 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 74 61 74   completion stat
2f90: 65 20 5c 66 49 70 61 72 73 65 5c 66 52 20 6f 66  e \fIparse\fR of
2fa0: 20 61 20 70 61 72 74 69 61 6c 0a 63 6f 6d 6d 61   a partial.comma
2fb0: 6e 64 20 6c 69 6e 65 20 69 74 20 72 65 74 75 72  nd line it retur
2fc0: 6e 73 20 61 20 6c 69 73 74 20 6f 66 20 73 74 72  ns a list of str
2fd0: 69 6e 67 73 20 77 68 69 63 68 20 61 72 65 20 74  ings which are t
2fe0: 68 65 20 76 61 6c 69 64 0a 63 6f 6d 70 6c 65 74  he valid.complet
2ff0: 69 6f 6e 73 20 61 74 20 74 68 69 73 20 70 6f 69  ions at this poi
3000: 6e 74 5c 26 2e 0a 2e 52 53 0a 2e 54 50 0a 64 69  nt\&...RS..TP.di
3010: 63 74 20 5c 66 49 70 61 72 73 65 5c 66 52 0a 41  ct \fIparse\fR.A
3020: 20 64 69 63 74 69 6f 6e 61 72 79 20 68 6f 6c 64   dictionary hold
3030: 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20  ing the current 
3040: 63 6f 6d 70 6c 65 74 69 6f 6e 20 73 74 61 74 65  completion state
3050: 20 6f 66 20 61 20 70 61 72 74 69 61 6c 20 63 6f   of a partial co
3060: 6d 6d 61 6e 64 0a 6c 69 6e 65 5c 26 2e 0a 2e 52  mmand.line\&...R
3070: 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66 69 67  E..TP.\fB<config
3080: 3e 5c 66 52 20 5c 66 42 63 6f 6e 74 69 6e 75 65  >\fR \fBcontinue
3090: 64 5c 66 52 20 5c 66 49 6c 69 6e 65 5c 66 52 0a  d\fR \fIline\fR.
30a0: 54 68 69 73 20 68 6f 6f 6b 2d 6d 65 74 68 6f 64  This hook-method
30b0: 20 66 6f 72 20 74 68 65 20 6d 69 6e 69 2d 73 68   for the mini-sh
30c0: 65 6c 6c 20 69 73 20 72 65 73 70 6f 6e 73 69 62  ell is responsib
30d0: 6c 65 20 66 6f 72 20 74 68 65 20 64 65 74 65 63  le for the detec
30e0: 74 69 6f 6e 0a 6f 66 20 61 20 63 6f 6e 74 69 6e  tion.of a contin
30f0: 75 61 74 69 6f 6e 2d 6c 69 6e 65 20 69 6e 20 74  uation-line in t
3100: 68 65 20 65 6e 74 65 72 65 64 20 63 6f 6d 6d 61  he entered comma
3110: 6e 64 20 5c 66 49 6c 69 6e 65 5c 66 52 5c 26 2e  nd \fIline\fR\&.
3120: 20 49 74 20 61 6c 77 61 79 73 0a 72 65 74 75 72   It always.retur
3130: 6e 73 20 74 68 65 20 62 6f 6f 6c 65 61 6e 20 76  ns the boolean v
3140: 61 6c 75 65 20 5c 66 42 66 61 6c 73 65 5c 66 52  alue \fBfalse\fR
3150: 20 61 73 20 74 68 65 20 6d 69 6e 69 2d 73 68 65   as the mini-she
3160: 6c 6c 20 64 6f 65 73 20 6e 6f 74 0a 73 75 70 70  ll does not.supp
3170: 6f 72 74 20 63 6f 6e 74 69 6e 75 61 74 69 6f 6e  ort continuation
3180: 20 6c 69 6e 65 73 5c 26 2e 0a 2e 52 53 0a 2e 54   lines\&...RS..T
3190: 50 0a 6c 69 73 74 20 5c 66 49 6c 69 73 74 5c 66  P.list \fIlist\f
31a0: 52 0a 2e 52 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f  R..RE..TP.\fB<co
31b0: 6e 66 69 67 3e 5c 66 52 20 5c 66 42 64 69 73 70  nfig>\fR \fBdisp
31c0: 61 74 63 68 5c 66 52 20 5c 66 49 63 6d 64 5c 66  atch\fR \fIcmd\f
31d0: 52 0a 54 68 69 73 20 68 6f 6f 6b 2d 6d 65 74 68  R.This hook-meth
31e0: 6f 64 20 66 6f 72 20 74 68 65 20 6d 69 6e 69 2d  od for the mini-
31f0: 73 68 65 6c 6c 20 69 73 20 72 65 73 70 6f 6e 73  shell is respons
3200: 69 62 6c 65 20 66 6f 72 0a 74 68 65 20 72 65 63  ible for.the rec
3210: 6f 67 6e 69 74 69 6f 6e 20 61 6e 64 20 65 78 65  ognition and exe
3220: 63 75 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 75  cution of the su
3230: 70 70 6f 72 74 65 64 20 63 6f 6d 6d 61 6e 64 73  pported commands
3240: 5c 26 2e 0a 2e 52 53 0a 2e 54 50 0a 73 74 72 69  \&...RS..TP.stri
3250: 6e 67 20 5c 66 49 63 6d 64 5c 66 52 0a 54 68 65  ng \fIcmd\fR.The
3260: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 63 6f   command line co
3270: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 6f 6d  ntaining the com
3280: 6d 61 6e 64 20 74 6f 20 72 75 6e 5c 26 2e 0a 2e  mand to run\&...
3290: 52 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66 69  RE..TP.\fB<confi
32a0: 67 3e 5c 66 52 20 5c 66 42 64 69 73 70 6c 61 79  g>\fR \fBdisplay
32b0: 5c 66 52 20 3f 5c 66 49 70 6c 69 73 74 5c 66 52  \fR ?\fIplist\fR
32c0: 3f 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 66 6f  ?.This method fo
32d0: 72 6d 61 74 73 20 74 68 65 20 63 68 6f 73 65 6e  rmats the chosen
32e0: 20 70 61 72 61 6d 65 74 65 72 73 20 66 6f 72 20   parameters for 
32f0: 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75  display and retu
3300: 72 6e 73 0a 74 68 65 20 72 65 73 75 6c 74 20 61  rns.the result a
3310: 73 20 61 20 73 74 72 69 6e 67 5c 26 2e 20 54 68  s a string\&. Th
3320: 69 73 20 69 6e 76 6f 6b 65 73 20 74 68 65 20 63  is invokes the c
3330: 68 6f 73 65 6e 20 64 69 73 70 6c 61 79 20 63 61  hosen display ca
3340: 6c 6c 62 61 63 6b 2c 0a 69 66 20 6f 6e 65 20 77  llback,.if one w
3350: 61 73 20 73 65 74 5c 26 2e 20 57 69 74 68 6f 75  as set\&. Withou
3360: 74 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 66 6f  t an internal fo
3370: 72 6d 61 74 74 65 72 20 69 73 20 75 73 65 64 20  rmatter is used 
3380: 69 6e 73 74 65 61 64 5c 26 2e 0a 2e 52 53 0a 2e  instead\&...RS..
3390: 54 50 0a 6c 69 73 74 20 5c 66 49 70 6c 69 73 74  TP.list \fIplist
33a0: 5c 66 52 0a 54 68 65 20 6c 69 73 74 20 6f 66 20  \fR.The list of 
33b0: 70 61 72 61 6d 65 74 65 72 73 20 28 62 79 20 6e  parameters (by n
33c0: 61 6d 65 29 20 74 6f 20 66 6f 72 6d 61 74 20 66  ame) to format f
33d0: 6f 72 20 64 69 73 70 6c 61 79 5c 26 2e 0a 49 66  or display\&..If
33e0: 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 20 74   not specified t
33f0: 68 65 20 6c 69 73 74 20 64 65 66 61 75 6c 74 20  he list default 
3400: 74 6f 20 74 68 65 20 73 65 74 20 6f 66 0a 5c 66  to the set of.\f
3410: 42 70 75 62 6c 69 63 5c 66 52 20 70 61 72 61 6d  Bpublic\fR param
3420: 65 74 65 72 73 20 70 6c 75 73 20 61 6e 79 20 75  eters plus any u
3430: 6e 64 6f 63 75 6d 65 6e 74 65 64 20 70 61 72 61  ndocumented para
3440: 6d 65 74 65 72 73 0a 61 6c 72 65 61 64 79 20 73  meters.already s
3450: 65 74 20 62 79 20 74 68 65 20 75 73 65 72 5c 26  et by the user\&
3460: 2e 0a 2e 52 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f  ...RE..TP.\fB<co
3470: 6e 66 69 67 3e 5c 66 52 20 5c 66 42 64 75 6d 70  nfig>\fR \fBdump
3480: 5c 66 52 0a 54 68 69 73 20 6d 65 74 68 6f 64 20  \fR.This method 
3490: 66 6f 72 6d 61 74 73 20 61 6c 6c 20 70 61 72 61  formats all para
34a0: 6d 65 74 65 72 73 20 66 6f 72 20 64 69 73 70 6c  meters for displ
34b0: 61 79 2c 20 75 73 69 6e 67 20 74 68 65 0a 69 6e  ay, using the.in
34c0: 74 65 72 6e 61 6c 20 66 6f 72 6d 61 74 74 65 72  ternal formatter
34d0: 2c 20 61 6e 64 20 72 65 74 75 72 6e 73 20 74 68  , and returns th
34e0: 65 20 72 65 73 75 6c 74 20 61 73 20 61 20 73 74  e result as a st
34f0: 72 69 6e 67 5c 26 2e 0a 55 73 65 66 75 6c 20 66  ring\&..Useful f
3500: 6f 72 20 64 65 62 75 67 67 69 6e 67 5c 26 2e 0a  or debugging\&..
3510: 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c  .TP.\fB<config>\
3520: 66 52 20 5c 66 42 65 6f 70 74 69 6f 6e 73 5c 66  fR \fBeoptions\f
3530: 52 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 72 65  R.This method re
3540: 74 75 72 6e 73 20 61 20 64 69 63 74 69 6f 6e 61  turns a dictiona
3550: 72 79 20 6d 61 70 70 69 6e 67 20 61 6c 6c 20 70  ry mapping all p
3560: 6f 73 73 69 62 6c 65 0a 6f 70 74 69 6f 6e 20 70  ossible.option p
3570: 72 65 66 69 78 65 73 20 74 6f 20 61 20 6c 69 73  refixes to a lis
3580: 74 20 6f 66 20 66 75 6c 6c 20 6f 70 74 69 6f 6e  t of full option
3590: 20 6e 61 6d 65 73 20 77 69 74 68 0a 74 68 61 74   names with.that
35a0: 20 70 72 65 66 69 78 5c 26 2e 0a 2e 54 50 0a 5c   prefix\&...TP.\
35b0: 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66  fB<config>\fR \f
35c0: 42 65 78 69 74 5c 66 52 0a 54 68 69 73 20 68 6f  Bexit\fR.This ho
35d0: 6f 6b 2d 6d 65 74 68 6f 64 20 66 6f 72 20 74 68  ok-method for th
35e0: 65 20 6d 69 6e 69 2d 73 68 65 6c 6c 20 72 65 74  e mini-shell ret
35f0: 75 72 6e 73 20 61 20 62 6f 6f 6c 65 61 6e 0a 76  urns a boolean.v
3600: 61 6c 75 65 20 69 6e 64 69 63 61 74 69 6e 67 20  alue indicating 
3610: 77 68 65 74 68 65 72 20 74 68 65 20 6d 69 6e 69  whether the mini
3620: 2d 73 68 65 6c 6c 20 77 61 73 20 73 74 6f 70 70  -shell was stopp
3630: 65 64 0a 61 6e 64 20 68 61 73 20 74 6f 20 65 78  ed.and has to ex
3640: 69 74 20 28 5c 66 42 74 72 75 65 5c 66 52 29 2c  it (\fBtrue\fR),
3650: 20 6f 72 20 6e 6f 74 20 28 5c 66 42 66 61 6c 73   or not (\fBfals
3660: 65 5c 66 52 29 5c 26 2e 0a 2e 54 50 0a 5c 66 42  e\fR)\&...TP.\fB
3670: 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 66  <config>\fR \fBf
3680: 6f 72 63 65 5c 66 52 20 3f 5c 66 49 61 6c 6c 6f  orce\fR ?\fIallo
3690: 77 69 6e 74 65 72 61 63 74 5c 66 52 3f 20 3f 5c  winteract\fR? ?\
36a0: 66 49 66 6f 72 63 65 64 65 66 65 72 65 64 5c 66  fIforcedefered\f
36b0: 52 3f 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 66  R?.This method f
36c0: 6f 72 63 65 73 20 74 68 65 20 63 61 6c 63 75 6c  orces the calcul
36d0: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 61 6c  ation of the val
36e0: 75 65 73 20 66 6f 72 20 61 6c 6c 20 70 61 72 61  ues for all para
36f0: 6d 65 74 65 72 73 0a 69 6e 20 74 68 65 20 63 6f  meters.in the co
3700: 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 6e 73 74  nfiguration inst
3710: 61 6e 63 65 5c 26 2e 20 54 68 69 73 20 69 73 20  ance\&. This is 
3720: 74 68 65 20 27 27 63 6f 6d 70 6c 65 74 69 6f 6e  the ''completion
3730: 20 70 68 61 73 65 27 27 5c 26 2e 0a 2e 52 53 0a   phase''\&...RS.
3740: 2e 54 50 0a 62 6f 6f 6c 65 61 6e 20 5c 66 49 61  .TP.boolean \fIa
3750: 6c 6c 6f 77 69 6e 74 65 72 61 63 74 5c 66 52 0a  llowinteract\fR.
3760: 49 66 20 73 70 65 63 69 66 69 65 64 20 61 73 20  If specified as 
3770: 5c 66 42 66 61 6c 73 65 5c 66 52 20 70 61 72 61  \fBfalse\fR para
3780: 6d 65 74 65 72 73 20 61 6c 6c 6f 77 69 6e 67 20  meters allowing 
3790: 74 68 65 20 69 6e 74 65 72 61 63 74 69 76 65 0a  the interactive.
37a0: 65 6e 74 72 79 20 6f 66 20 74 68 65 69 72 20 76  entry of their v
37b0: 61 6c 75 65 20 68 61 76 65 20 74 68 69 73 20 66  alue have this f
37c0: 65 61 74 75 72 65 20 64 69 73 61 62 6c 65 64 20  eature disabled 
37d0: 66 6f 72 20 74 68 65 20 6f 70 65 72 61 74 69 6f  for the operatio
37e0: 6e 5c 26 2e 0a 54 68 65 20 64 65 66 61 75 6c 74  n\&..The default
37f0: 20 69 73 20 5c 66 42 74 72 75 65 5c 66 52 2c 20   is \fBtrue\fR, 
3800: 61 6c 6c 6f 77 69 6e 67 20 66 6f 72 20 74 68 65  allowing for the
3810: 20 69 6e 74 65 72 61 63 74 69 6f 6e 5c 26 2e 0a   interaction\&..
3820: 2e 54 50 0a 62 6f 6f 6c 65 61 6e 20 5c 66 49 66  .TP.boolean \fIf
3830: 6f 72 63 65 64 65 66 65 72 65 64 5c 66 52 0a 49  orcedefered\fR.I
3840: 66 20 73 70 65 63 69 66 69 65 64 20 61 73 20 5c  f specified as \
3850: 66 42 74 72 75 65 5c 66 52 20 65 76 65 6e 20 70  fBtrue\fR even p
3860: 61 72 61 6d 65 74 65 72 73 20 6d 61 72 6b 65 64  arameters marked
3870: 20 61 73 20 22 64 65 66 65 72 65 64 22 0a 61 72   as "defered".ar
3880: 65 20 66 6f 72 63 65 64 20 74 6f 20 67 65 6e 65  e forced to gene
3890: 72 61 74 65 20 74 68 65 69 72 20 76 61 6c 75 65  rate their value
38a0: 5c 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20  \&. The default 
38b0: 69 73 20 5c 66 42 66 61 6c 73 65 5c 66 52 2c 0a  is \fBfalse\fR,.
38c0: 63 61 75 73 69 6e 67 20 74 68 65 20 6d 65 74 68  causing the meth
38d0: 6f 64 20 74 6f 20 69 67 6e 6f 72 65 20 73 75 63  od to ignore suc
38e0: 68 20 70 61 72 61 6d 65 74 65 72 73 5c 26 2e 0a  h parameters\&..
38f0: 2e 52 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66  .RE..TP.\fB<conf
3900: 69 67 3e 5c 66 52 20 5c 66 42 66 6f 72 67 65 74  ig>\fR \fBforget
3910: 5c 66 52 0a 54 68 69 73 20 6d 65 74 68 6f 64 20  \fR.This method 
3920: 69 6e 76 6f 6b 65 73 20 74 68 65 20 70 61 72 61  invokes the para
3930: 6d 65 74 65 72 20 6d 65 74 68 6f 64 20 5c 66 42  meter method \fB
3940: 66 6f 72 67 65 74 5c 66 52 20 6f 6e 20 61 6c 6c  forget\fR on all
3950: 0a 70 61 72 61 6d 65 74 65 72 73 20 69 6e 20 74  .parameters in t
3960: 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  he configuration
3970: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66  \&...TP.\fB<conf
3980: 69 67 3e 5c 66 52 20 5c 66 42 68 61 73 5c 66 52  ig>\fR \fBhas\fR
3990: 20 5c 66 49 6e 61 6d 65 5c 66 52 0a 54 68 69 73   \fIname\fR.This
39a0: 20 6d 65 74 68 6f 64 20 63 68 65 63 6b 73 20 69   method checks i
39b0: 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74  f the configurat
39c0: 69 6f 6e 20 69 6e 73 74 61 6e 63 65 20 63 6f 6e  ion instance con
39d0: 74 61 69 6e 73 0a 61 20 70 61 72 61 6d 65 74 65  tains.a paramete
39e0: 72 20 77 69 74 68 20 74 68 65 20 73 70 65 63 69  r with the speci
39f0: 66 69 65 64 20 5c 66 49 6e 61 6d 65 5c 66 52 20  fied \fIname\fR 
3a00: 61 6e 64 20 72 65 74 75 72 6e 73 20 61 0a 62 6f  and returns a.bo
3a10: 6f 6c 65 61 6e 20 76 61 6c 75 65 20 69 6e 64 69  olean value indi
3a20: 63 61 74 69 6e 67 20 77 68 65 74 68 65 72 20 74  cating whether t
3a30: 68 65 20 70 61 72 61 6d 65 74 65 72 20 65 78 69  he parameter exi
3a40: 73 74 73 0a 28 5c 66 42 74 72 75 65 5c 66 52 29  sts.(\fBtrue\fR)
3a50: 2c 20 6f 72 20 6e 6f 74 20 28 5c 66 42 66 61 6c  , or not (\fBfal
3a60: 73 65 5c 66 52 29 5c 26 2e 0a 2e 52 53 0a 2e 54  se\fR)\&...RS..T
3a70: 50 0a 73 74 72 69 6e 67 20 5c 66 49 6e 61 6d 65  P.string \fIname
3a80: 5c 66 52 0a 54 68 65 20 6e 61 6d 65 20 6f 66 20  \fR.The name of 
3a90: 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 74 6f  the parameter to
3aa0: 20 63 68 65 63 6b 20 66 6f 72 20 65 78 69 73 74   check for exist
3ab0: 65 6e 63 65 0a 2e 52 45 0a 2e 54 50 0a 5c 66 42  ence..RE..TP.\fB
3ac0: 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 68  <config>\fR \fBh
3ad0: 65 6c 70 5c 66 52 20 3f 5c 66 49 6d 6f 64 65 5c  elp\fR ?\fImode\
3ae0: 66 52 3f 0a 54 68 69 73 20 6d 65 74 68 6f 64 20  fR?.This method 
3af0: 72 65 74 75 72 6e 73 20 74 68 65 20 68 65 6c 70  returns the help
3b00: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 6f 72   information for
3b10: 20 74 68 65 0a 70 61 72 61 6d 65 74 65 72 73 20   the.parameters 
3b20: 68 65 6c 64 20 69 6e 20 74 68 65 20 63 6f 6e 66  held in the conf
3b30: 69 67 75 72 61 74 69 6f 6e 5c 26 2e 0a 54 68 65  iguration\&..The
3b40: 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 20 63   result of the c
3b50: 6f 6d 6d 61 6e 64 20 69 73 20 61 20 73 74 72 75  ommand is a stru
3b60: 63 74 75 72 65 20 6f 66 20 74 68 65 20 66 6f 72  cture of the for
3b70: 6d 0a 64 65 73 63 72 69 62 65 64 20 69 6e 20 73  m.described in s
3b80: 65 63 74 69 6f 6e 20 5c 66 42 48 65 6c 70 20 49  ection \fBHelp I
3b90: 6e 66 6f 72 6d 61 74 69 6f 6e 5c 66 52 5c 26 2e  nformation\fR\&.
3ba0: 0a 2e 52 53 0a 2e 54 50 0a 65 6e 75 6d 20 5c 66  ..RS..TP.enum \f
3bb0: 49 6d 6f 64 65 5c 66 52 0a 54 68 65 20 70 6f 73  Imode\fR.The pos
3bc0: 73 69 62 6c 65 20 6d 6f 64 65 73 20 61 72 65 20  sible modes are 
3bd0: 5c 66 42 70 75 62 6c 69 63 5c 66 52 20 61 6e 64  \fBpublic\fR and
3be0: 20 5c 66 42 69 6e 74 65 72 61 63 74 5c 66 52 5c   \fBinteract\fR\
3bf0: 26 2e 0a 49 66 20 6e 6f 74 20 73 70 65 63 69 66  &..If not specif
3c00: 69 65 64 20 5c 66 42 70 75 62 6c 69 63 5c 66 52  ied \fBpublic\fR
3c10: 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 5c   is the default\
3c20: 26 2e 0a 49 6e 20 74 68 69 73 20 6d 6f 64 65 20  &..In this mode 
3c30: 6f 6e 6c 79 20 22 64 6f 63 75 6d 65 6e 74 65 64  only "documented
3c40: 22 20 70 61 72 61 6d 65 74 65 72 73 20 61 72 65  " parameters are
3c50: 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65   included in the
3c60: 20 68 65 6c 70 5c 26 2e 0a 49 6e 20 6d 6f 64 65   help\&..In mode
3c70: 20 22 69 6e 74 65 72 61 63 74 22 2c 20 75 73 65   "interact", use
3c80: 64 20 62 79 20 74 68 65 20 6d 69 6e 69 2d 73 68  d by the mini-sh
3c90: 65 6c 6c 20 75 6e 64 6f 63 75 6d 65 6e 74 65 64  ell undocumented
3ca0: 20 70 61 72 61 6d 65 74 65 72 73 0a 61 72 65 20   parameters.are 
3cb0: 69 6e 63 6c 75 64 65 64 20 61 73 20 77 65 6c 6c  included as well
3cc0: 2c 20 69 66 20 74 68 65 79 20 61 72 65 20 61 6c  , if they are al
3cd0: 72 65 61 64 79 20 73 65 74 20 62 79 20 74 68 65  ready set by the
3ce0: 20 75 73 65 72 5c 26 2e 0a 2e 52 45 0a 2e 54 50   user\&...RE..TP
3cf0: 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20  .\fB<config>\fR 
3d00: 5c 66 42 69 6e 74 65 72 61 63 74 5c 66 52 0a 54  \fBinteract\fR.T
3d10: 68 69 73 20 6d 65 74 68 6f 64 20 69 6e 76 6f 6b  his method invok
3d20: 65 73 20 74 68 65 20 6d 69 6e 69 2d 73 68 65 6c  es the mini-shel
3d30: 6c 20 66 6f 72 20 69 6e 74 65 72 61 63 74 69 76  l for interactiv
3d40: 65 20 70 61 72 61 6d 65 74 65 72 20 65 6e 74 72  e parameter entr
3d50: 79 5c 26 2e 0a 49 74 20 72 65 74 75 72 6e 73 20  y\&..It returns 
3d60: 6f 6e 20 65 78 69 74 20 66 72 6f 6d 20 74 68 65  on exit from the
3d70: 20 73 68 65 6c 6c 5c 26 2e 0a 54 68 65 20 72 65   shell\&..The re
3d80: 73 75 6c 74 20 6f 66 20 74 68 65 20 6d 65 74 68  sult of the meth
3d90: 6f 64 20 69 73 20 74 68 65 20 65 6d 70 74 79 20  od is the empty 
3da0: 73 74 72 69 6e 67 5c 26 2e 0a 2e 54 50 0a 5c 66  string\&...TP.\f
3db0: 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42  B<config>\fR \fB
3dc0: 69 6e 74 65 72 61 63 74 69 76 65 5c 66 52 0a 54  interactive\fR.T
3dd0: 68 69 73 20 61 63 63 65 73 73 6f 72 20 6d 65 74  his accessor met
3de0: 68 6f 64 20 72 65 74 75 72 6e 73 20 61 20 62 6f  hod returns a bo
3df0: 6f 6c 65 61 6e 20 76 61 6c 75 65 20 69 6e 64 69  olean value indi
3e00: 63 61 74 69 6e 67 20 77 68 65 74 68 65 72 20 75  cating whether u
3e10: 73 65 0a 6f 66 20 74 68 65 20 6d 69 6e 69 2d 73  se.of the mini-s
3e20: 68 65 6c 6c 20 69 73 20 61 6c 6c 6f 77 65 64 20  hell is allowed 
3e30: 28 5c 66 42 74 72 75 65 5c 66 52 29 2c 20 6f 72  (\fBtrue\fR), or
3e40: 20 6e 6f 74 20 28 5c 66 42 66 61 6c 73 65 5c 66   not (\fBfalse\f
3e50: 52 29 5c 26 2e 0a 2e 54 50 0a 5c 66 42 3c 63 6f  R)\&...TP.\fB<co
3e60: 6e 66 69 67 3e 5c 66 52 20 5c 66 42 6c 6f 6f 6b  nfig>\fR \fBlook
3e70: 75 70 5c 66 52 20 5c 66 49 6e 61 6d 65 5c 66 52  up\fR \fIname\fR
3e80: 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 63 68 65  .This method che
3e90: 63 6b 73 20 69 66 20 74 68 65 20 63 6f 6e 66 69  cks if the confi
3ea0: 67 75 72 61 74 69 6f 6e 20 69 6e 73 74 61 6e 63  guration instanc
3eb0: 65 20 63 6f 6e 74 61 69 6e 73 0a 61 20 70 61 72  e contains.a par
3ec0: 61 6d 65 74 65 72 20 77 69 74 68 20 74 68 65 20  ameter with the 
3ed0: 73 70 65 63 69 66 69 65 64 20 5c 66 49 6e 61 6d  specified \fInam
3ee0: 65 5c 66 52 20 61 6e 64 20 72 65 74 75 72 6e 73  e\fR and returns
3ef0: 20 69 74 73 0a 69 6e 73 74 61 6e 63 65 5c 26 2e   its.instance\&.
3f00: 20 41 6e 20 65 72 72 6f 72 20 69 73 20 74 68 72   An error is thr
3f10: 6f 77 6e 20 69 66 20 74 68 65 20 70 61 72 61 6d  own if the param
3f20: 65 74 65 72 20 69 73 20 6e 6f 74 20 6b 6e 6f 77  eter is not know
3f30: 6e 5c 26 2e 0a 2e 52 53 0a 2e 54 50 0a 73 74 72  n\&...RS..TP.str
3f40: 69 6e 67 20 5c 66 49 6e 61 6d 65 5c 66 52 0a 54  ing \fIname\fR.T
3f50: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 70  he name of the p
3f60: 61 72 61 6d 65 74 65 72 20 74 6f 20 72 65 74 72  arameter to retr
3f70: 69 65 76 65 5c 26 2e 0a 2e 52 45 0a 2e 54 50 0a  ieve\&...RE..TP.
3f80: 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c  \fB<config>\fR \
3f90: 66 42 6c 6f 6f 6b 75 70 2d 6f 70 74 69 6f 6e 5c  fBlookup-option\
3fa0: 66 52 20 5c 66 49 6e 61 6d 65 5c 66 52 0a 54 68  fR \fIname\fR.Th
3fb0: 69 73 20 6d 65 74 68 6f 64 20 63 68 65 63 6b 73  is method checks
3fc0: 20 69 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72   if the configur
3fd0: 61 74 69 6f 6e 20 69 6e 73 74 61 6e 63 65 20 63  ation instance c
3fe0: 6f 6e 74 61 69 6e 73 0a 61 20 70 61 72 61 6d 65  ontains.a parame
3ff0: 74 65 72 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20  ter controlling 
4000: 74 68 65 20 73 70 65 63 69 66 69 65 64 20 6f 70  the specified op
4010: 74 69 6f 6e 20 5c 66 49 6e 61 6d 65 5c 66 52 0a  tion \fIname\fR.
4020: 61 6e 64 20 72 65 74 75 72 6e 73 20 69 74 73 20  and returns its 
4030: 69 6e 73 74 61 6e 63 65 5c 26 2e 20 41 6e 20 65  instance\&. An e
4040: 72 72 6f 72 20 69 73 20 74 68 72 6f 77 6e 20 69  rror is thrown i
4050: 66 20 74 68 65 20 6f 70 74 69 6f 6e 0a 69 73 20  f the option.is 
4060: 6e 6f 74 20 6b 6e 6f 77 6e 5c 26 2e 0a 2e 52 53  not known\&...RS
4070: 0a 2e 54 50 0a 73 74 72 69 6e 67 20 5c 66 49 6e  ..TP.string \fIn
4080: 61 6d 65 5c 66 52 0a 54 68 65 20 6f 70 74 69 6f  ame\fR.The optio
4090: 6e 20 66 6c 61 67 20 74 6f 20 66 69 6e 64 20 74  n flag to find t
40a0: 68 65 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20 70  he controlling p
40b0: 61 72 61 6d 65 74 65 72 20 66 6f 72 5c 26 2e 0a  arameter for\&..
40c0: 2e 52 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66  .RE..TP.\fB<conf
40d0: 69 67 3e 5c 66 52 20 5c 66 42 6d 69 73 73 69 6e  ig>\fR \fBmissin
40e0: 67 4f 70 74 69 6f 6e 56 61 6c 75 65 5c 66 52 20  gOptionValue\fR 
40f0: 5c 66 49 6e 61 6d 65 5c 66 52 0a 54 68 69 73 20  \fIname\fR.This 
4100: 6d 65 74 68 6f 64 20 74 68 72 6f 77 73 20 74 68  method throws th
4110: 65 20 73 74 61 6e 64 61 72 64 20 65 72 72 6f 72  e standard error
4120: 20 66 6f 72 20 77 68 65 6e 20 74 68 65 20 6f 70   for when the op
4130: 74 69 6f 6e 20 5c 66 49 6e 61 6d 65 5c 66 52 0a  tion \fIname\fR.
4140: 72 65 71 75 69 72 69 6e 67 20 61 6e 20 61 72 67  requiring an arg
4150: 75 6d 65 6e 74 20 76 61 6c 75 65 20 64 6f 65 73  ument value does
4160: 20 6e 6f 74 20 68 61 76 65 20 6f 6e 65 5c 26 2e   not have one\&.
4170: 20 53 65 65 20 74 68 65 0a 6d 65 74 68 6f 64 73   See the.methods
4180: 20 5c 66 42 6e 6f 74 45 6e 6f 75 67 68 5c 66 52   \fBnotEnough\fR
4190: 20 61 6e 64 20 5c 66 42 74 6f 6f 4d 61 6e 79 5c   and \fBtooMany\
41a0: 66 52 20 61 73 20 77 65 6c 6c 5c 26 2e 0a 2e 52  fR as well\&...R
41b0: 53 0a 2e 54 50 0a 73 74 72 69 6e 67 20 5c 66 49  S..TP.string \fI
41c0: 6e 61 6d 65 5c 66 52 0a 54 68 65 20 66 6c 61 67  name\fR.The flag
41d0: 20 74 72 69 67 67 65 72 69 6e 67 20 74 68 65 20   triggering the 
41e0: 65 72 72 6f 72 5c 26 2e 0a 2e 52 45 0a 2e 54 50  error\&...RE..TP
41f0: 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20  .\fB<config>\fR 
4200: 5c 66 42 6e 61 6d 65 73 5c 66 52 0a 54 68 69 73  \fBnames\fR.This
4210: 20 6d 65 74 68 6f 64 20 72 65 74 75 72 6e 73 20   method returns 
4220: 61 20 6c 69 73 74 20 6f 66 20 70 61 72 61 6d 65  a list of parame
4230: 74 65 72 20 6e 61 6d 65 73 2c 20 66 6f 72 20 61  ter names, for a
4240: 6c 6c 20 70 61 72 61 6d 65 74 65 72 73 5c 26 2e  ll parameters\&.
4250: 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e  ..TP.\fB<config>
4260: 5c 66 52 20 5c 66 42 6e 6f 74 45 6e 6f 75 67 68  \fR \fBnotEnough
4270: 5c 66 52 0a 54 68 69 73 20 6d 65 74 68 6f 64 20  \fR.This method 
4280: 74 68 72 6f 77 73 20 74 68 65 20 73 74 61 6e 64  throws the stand
4290: 61 72 64 20 65 72 72 6f 72 20 66 6f 72 20 77 68  ard error for wh
42a0: 65 6e 20 61 20 63 6f 6d 6d 61 6e 64 20 69 73 20  en a command is 
42b0: 66 6f 75 6e 64 0a 74 6f 20 62 65 20 73 75 70 70  found.to be supp
42c0: 6c 69 65 64 20 77 69 74 68 20 6e 6f 74 20 65 6e  lied with not en
42d0: 6f 75 67 68 20 61 72 67 75 6d 65 6e 74 73 20 66  ough arguments f
42e0: 6f 72 20 69 74 73 20 70 61 72 61 6d 65 74 65 72  or its parameter
42f0: 73 5c 26 2e 20 53 65 65 0a 74 68 65 20 6d 65 74  s\&. See.the met
4300: 68 6f 64 73 20 5c 66 42 6d 69 73 73 69 6e 67 4f  hods \fBmissingO
4310: 70 74 69 6f 6e 56 61 6c 75 65 5c 66 52 20 61 6e  ptionValue\fR an
4320: 64 20 5c 66 42 74 6f 6f 4d 61 6e 79 5c 66 52 20  d \fBtooMany\fR 
4330: 61 73 20 77 65 6c 6c 5c 26 2e 0a 2e 54 50 0a 5c  as well\&...TP.\
4340: 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66  fB<config>\fR \f
4350: 42 6f 70 74 69 6f 6e 73 5c 66 52 0a 54 68 69 73  Boptions\fR.This
4360: 20 6d 65 74 68 6f 64 20 72 65 74 75 72 6e 73 20   method returns 
4370: 61 20 6c 69 73 74 20 6f 66 20 74 68 65 20 6f 70  a list of the op
4380: 74 69 6f 6e 20 66 6c 61 67 73 20 72 65 63 6f 67  tion flags recog
4390: 6e 69 7a 65 64 0a 62 79 20 74 68 65 20 70 61 72  nized.by the par
43a0: 61 6d 65 74 65 72 73 20 69 6e 20 74 68 65 20 63  ameters in the c
43b0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 5c 26 2e 20  onfiguration\&. 
43c0: 54 68 69 73 20 64 6f 65 73 20 6e 6f 74 20 69 6e  This does not in
43d0: 63 6c 75 64 65 0a 6f 70 74 69 6f 6e 20 70 72 65  clude.option pre
43e0: 66 69 78 65 73 5c 26 2e 0a 2e 54 50 0a 5c 66 42  fixes\&...TP.\fB
43f0: 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 70  <config>\fR \fBp
4400: 61 72 73 65 5c 66 52 20 3f 5c 66 49 77 6f 72 64  arse\fR ?\fIword
4410: 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 0a 54 68  \&.\&.\&.\fR?.Th
4420: 69 73 20 6d 65 74 68 6f 64 20 70 61 72 73 65 73  is method parses
4430: 20 74 68 65 20 77 6f 72 64 73 20 28 66 72 6f 6d   the words (from
4440: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e   the command lin
4450: 65 29 20 61 6e 64 0a 6d 61 70 73 20 74 68 65 6d  e) and.maps them
4460: 20 74 6f 20 70 61 72 61 6d 65 74 65 72 73 2c 20   to parameters, 
4470: 62 61 73 65 64 20 6f 6e 20 6e 61 6d 69 6e 67 20  based on naming 
4480: 28 6f 70 74 69 6f 6e 73 20 61 6e 64 20 66 6c 61  (options and fla
4490: 67 73 29 2c 0a 6f 72 20 70 6f 73 69 74 69 6f 6e  gs),.or position
44a0: 20 28 61 72 67 75 6d 65 6e 74 73 29 5c 26 2e 0a   (arguments)\&..
44b0: 2e 52 53 0a 2e 54 50 0a 6c 69 73 74 20 5c 66 49  .RS..TP.list \fI
44c0: 77 6f 72 64 5c 66 52 0a 54 68 65 20 77 6f 72 64  word\fR.The word
44d0: 73 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64  s of the command
44e0: 20 73 70 65 63 69 66 79 69 6e 67 20 74 68 65 20   specifying the 
44f0: 70 61 72 61 6d 65 74 65 72 73 20 6f 66 20 74 68  parameters of th
4500: 65 20 70 72 69 76 61 74 65 0a 68 6f 6c 64 69 6e  e private.holdin
4510: 67 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74  g the configurat
4520: 69 6f 6e 20 69 6e 73 74 61 6e 63 65 5c 26 2e 0a  ion instance\&..
4530: 2e 52 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66  .RE..TP.\fB<conf
4540: 69 67 3e 5c 66 52 20 5c 66 42 70 61 72 73 65 2d  ig>\fR \fBparse-
4550: 6f 70 74 69 6f 6e 73 5c 66 52 0a 54 68 69 73 20  options\fR.This 
4560: 6d 65 74 68 6f 64 20 69 73 20 61 20 68 65 6c 70  method is a help
4570: 65 72 20 66 6f 72 20 5c 66 42 70 61 72 73 65 5c  er for \fBparse\
4580: 66 52 20 61 62 6f 76 65 5c 26 2e 0a 41 63 63 65  fR above\&..Acce
4590: 73 73 69 6e 67 20 74 68 65 20 69 6e 74 65 72 6e  ssing the intern
45a0: 61 6c 20 71 75 65 75 65 20 69 6e 69 74 69 61 6c  al queue initial
45b0: 69 7a 65 64 20 62 79 20 5c 66 42 70 61 72 73 65  ized by \fBparse
45c0: 5c 66 52 0a 69 74 20 73 70 6c 69 74 73 20 61 72  \fR.it splits ar
45d0: 67 75 6d 65 6e 74 73 20 61 6e 64 20 6f 70 74 69  guments and opti
45e0: 6f 6e 73 2c 20 70 72 6f 63 65 73 73 69 6e 67 20  ons, processing 
45f0: 61 6c 6c 20 74 68 65 20 6c 61 74 74 65 72 5c 26  all the latter\&
4600: 2e 0a 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20  ..The arguments 
4610: 61 72 65 20 70 75 74 20 62 61 63 6b 20 69 6e 74  are put back int
4620: 6f 20 74 68 65 20 71 75 65 75 65 2c 20 69 6e 20  o the queue, in 
4630: 74 68 65 20 6f 72 64 65 72 0a 74 68 65 79 20 77  the order.they w
4640: 65 72 65 20 66 6f 75 6e 64 20 69 6e 5c 26 2e 0a  ere found in\&..
4650: 54 68 69 73 20 69 73 20 75 73 65 64 20 62 79 20  This is used by 
4660: 70 61 72 61 6d 65 74 65 72 73 20 28 6f 70 74 69  parameters (opti
4670: 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74 73 29 20  onal arguments) 
4680: 75 73 69 6e 67 20 74 68 65 0a 72 65 67 75 6c 61  using the.regula
4690: 72 20 74 68 72 65 73 68 6f 6c 64 2d 72 65 67 69  r threshold-regi
46a0: 6d 65 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20  me to determine 
46b0: 61 63 63 65 70 74 61 6e 63 65 5c 26 2e 20 41 6c  acceptance\&. Al
46c0: 6c 20 6f 70 74 69 6f 6e 73 0a 73 74 69 6c 6c 20  l options.still 
46d0: 69 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c  in the command l
46e0: 69 6e 65 20 6d 75 73 74 20 62 65 20 72 65 6d 6f  ine must be remo
46f0: 76 65 64 20 28 61 6e 64 20 70 72 6f 63 65 73 73  ved (and process
4700: 65 64 29 20 74 6f 0a 6b 6e 6f 77 20 74 68 65 20  ed) to.know the 
4710: 70 72 6f 70 65 72 20 6e 75 6d 62 65 72 20 6f 66  proper number of
4720: 20 61 72 67 75 6d 65 6e 74 73 20 77 6f 72 64 73   arguments words
4730: 20 6c 65 66 74 5c 26 2e 0a 2e 54 50 0a 5c 66 42   left\&...TP.\fB
4740: 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 70  <config>\fR \fBp
4750: 72 6f 6d 70 74 31 5c 66 52 0a 54 68 69 73 20 68  rompt1\fR.This h
4760: 6f 6f 6b 2d 6d 65 74 68 6f 64 20 66 6f 72 20 74  ook-method for t
4770: 68 65 20 6d 69 6e 69 2d 73 68 65 6c 6c 20 72 65  he mini-shell re
4780: 74 75 72 6e 73 20 74 68 65 20 70 72 69 6d 61 72  turns the primar
4790: 79 0a 70 72 6f 6d 70 74 20 73 74 72 69 6e 67 20  y.prompt string 
47a0: 74 6f 20 75 73 65 5c 26 2e 0a 2e 54 50 0a 5c 66  to use\&...TP.\f
47b0: 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42  B<config>\fR \fB
47c0: 70 72 6f 6d 70 74 32 5c 66 52 0a 54 68 69 73 20  prompt2\fR.This 
47d0: 68 6f 6f 6b 2d 6d 65 74 68 6f 64 20 66 6f 72 20  hook-method for 
47e0: 74 68 65 20 6d 69 6e 69 2d 73 68 65 6c 6c 20 72  the mini-shell r
47f0: 65 74 75 72 6e 73 20 74 68 65 20 73 65 63 6f 6e  eturns the secon
4800: 64 61 72 79 0a 70 72 6f 6d 70 74 20 73 74 72 69  dary.prompt stri
4810: 6e 67 20 66 6f 72 20 75 73 65 20 77 69 74 68 69  ng for use withi
4820: 6e 20 61 20 63 6f 6e 74 69 6e 75 61 74 69 6f 6e  n a continuation
4830: 5c 26 2e 20 41 73 20 74 68 65 20 6d 69 6e 69 2d  \&. As the mini-
4840: 73 68 65 6c 6c 0a 64 6f 65 73 20 6e 6f 74 20 73  shell.does not s
4850: 75 70 70 6f 72 74 20 63 6f 6e 74 69 6e 75 61 74  upport continuat
4860: 69 6f 6e 20 6c 69 6e 65 73 20 69 74 20 73 68 6f  ion lines it sho
4870: 75 6c 64 20 6e 6f 74 20 62 65 20 69 6e 76 6f 6b  uld not be invok
4880: 65 64 0a 65 76 65 72 2c 20 61 6e 64 20 74 68 75  ed.ever, and thu
4890: 73 20 61 6c 77 61 79 73 20 74 68 72 6f 77 73 20  s always throws 
48a0: 61 6e 20 65 72 72 6f 72 20 73 68 6f 75 6c 64 20  an error should 
48b0: 69 74 20 62 65 20 69 6e 76 6f 6b 65 64 5c 26 2e  it be invoked\&.
48c0: 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e  ..TP.\fB<config>
48d0: 5c 66 52 20 5c 66 42 70 75 62 6c 69 63 5c 66 52  \fR \fBpublic\fR
48e0: 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 61 20 6c  .This method a l
48f0: 69 73 74 20 6f 66 20 70 61 72 61 6d 65 74 65 72  ist of parameter
4900: 20 6e 61 6d 65 73 2c 20 66 6f 72 20 61 6c 6c 20   names, for all 
4910: 64 6f 63 75 6d 65 6e 74 65 64 0a 6f 70 74 69 6f  documented.optio
4920: 6e 20 61 6e 64 20 61 72 67 75 6d 65 6e 74 20 70  n and argument p
4930: 61 72 61 6d 65 74 65 72 73 5c 26 2e 0a 2e 54 50  arameters\&...TP
4940: 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52 20  .\fB<config>\fR 
4950: 5c 66 42 72 61 69 73 65 5c 66 52 20 5c 66 49 6d  \fBraise\fR \fIm
4960: 73 67 5c 66 52 20 3f 5c 66 49 77 6f 72 64 5c 26  sg\fR ?\fIword\&
4970: 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 0a 54 68 69 73  .\&.\&.\fR?.This
4980: 20 6d 65 74 68 6f 64 20 69 73 20 61 20 68 65 6c   method is a hel
4990: 70 65 72 20 66 6f 72 20 6d 65 74 68 6f 64 73 20  per for methods 
49a0: 5c 66 42 74 6f 6f 4d 61 6e 79 5c 66 52 2c 20 5c  \fBtooMany\fR, \
49b0: 66 42 6e 6f 74 45 6e 6f 75 67 68 5c 66 52 2c 0a  fBnotEnough\fR,.
49c0: 61 6e 64 20 5c 66 42 6d 69 73 73 69 6e 67 4f 70  and \fBmissingOp
49d0: 74 69 6f 6e 56 61 6c 75 65 5c 66 52 2c 20 64 6f  tionValue\fR, do
49e0: 69 6e 67 20 74 68 65 20 62 75 6c 6b 20 6f 66 20  ing the bulk of 
49f0: 74 68 65 20 77 6f 72 6b 5c 26 2e 0a 2e 52 53 0a  the work\&...RS.
4a00: 2e 54 50 0a 73 74 72 69 6e 67 20 5c 66 49 6d 73  .TP.string \fIms
4a10: 67 5c 66 52 0a 54 68 65 20 68 75 6d 61 6e 2d 72  g\fR.The human-r
4a20: 65 61 64 61 62 6c 65 20 65 72 72 6f 72 20 6d 65  eadable error me
4a30: 73 73 61 67 65 20 74 6f 20 75 73 65 5c 26 2e 0a  ssage to use\&..
4a40: 2e 54 50 0a 6c 69 73 74 20 5c 66 49 77 6f 72 64  .TP.list \fIword
4a50: 5c 66 52 0a 54 68 65 20 6d 61 63 68 69 6e 65 2d  \fR.The machine-
4a60: 72 65 61 64 61 62 6c 65 20 28 74 72 61 70 2d 61  readable (trap-a
4a70: 62 6c 65 29 20 65 72 72 6f 72 20 63 6f 64 65 20  ble) error code 
4a80: 74 6f 20 75 73 65 5c 26 2e 0a 2e 52 45 0a 2e 54  to use\&...RE..T
4a90: 50 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66 52  P.\fB<config>\fR
4aa0: 20 5c 66 42 72 65 70 6f 72 74 5c 66 52 20 5c 66   \fBreport\fR \f
4ab0: 49 77 68 61 74 5c 66 52 20 5c 66 49 64 61 74 61  Iwhat\fR \fIdata
4ac0: 5c 66 52 0a 54 68 69 73 20 68 6f 6f 6b 2d 6d 65  \fR.This hook-me
4ad0: 74 68 6f 64 20 66 6f 72 20 74 68 65 20 6d 69 6e  thod for the min
4ae0: 69 2d 73 68 65 6c 6c 20 69 73 20 72 65 73 70 6f  i-shell is respo
4af0: 6e 73 69 62 6c 65 20 66 6f 72 20 74 68 65 0a 72  nsible for the.r
4b00: 65 70 6f 72 74 69 6e 67 20 6f 66 20 74 68 65 20  eporting of the 
4b10: 63 6f 6d 6d 61 6e 64 20 72 65 73 75 6c 74 73 20  command results 
4b20: 61 6e 64 20 68 61 6e 64 6c 65 73 20 74 68 65 20  and handles the 
4b30: 64 69 73 70 6c 61 79 20 6f 66 0a 74 68 65 20 70  display of.the p
4b40: 61 72 61 6d 65 74 65 72 20 73 74 61 74 65 20 62  arameter state b
4b50: 65 66 6f 72 65 20 61 20 6e 65 77 20 70 72 6f 6d  efore a new prom
4b60: 70 74 5c 26 2e 0a 2e 73 70 0a 49 74 73 20 72 65  pt\&...sp.Its re
4b70: 73 75 6c 74 20 69 73 20 74 68 65 20 65 6d 70 74  sult is the empt
4b80: 79 20 73 74 72 69 6e 67 5c 26 2e 0a 2e 52 53 0a  y string\&...RS.
4b90: 2e 54 50 0a 65 6e 75 6d 20 5c 66 49 77 68 61 74  .TP.enum \fIwhat
4ba0: 5c 66 52 0a 54 68 65 20 72 65 73 75 6c 74 20 63  \fR.The result c
4bb0: 6f 64 65 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61  ode of the comma
4bc0: 6e 64 2c 20 6f 6e 65 20 6f 66 20 5c 66 42 6f 6b  nd, one of \fBok
4bd0: 5c 66 52 2c 20 6f 72 20 5c 66 42 66 61 69 6c 5c  \fR, or \fBfail\
4be0: 66 52 5c 26 2e 0a 2e 54 50 0a 61 6e 79 20 5c 66  fR\&...TP.any \f
4bf0: 49 64 61 74 61 5c 66 52 0a 54 68 65 20 72 65 73  Idata\fR.The res
4c00: 75 6c 74 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61  ult of the comma
4c10: 6e 64 2c 20 6f 72 20 61 6e 20 65 72 72 6f 72 20  nd, or an error 
4c20: 6d 65 73 73 61 67 65 20 69 6e 20 63 61 73 65 20  message in case 
4c30: 6f 66 20 66 61 69 6c 75 72 65 5c 26 2e 0a 2e 52  of failure\&...R
4c40: 45 0a 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66 69 67  E..TP.\fB<config
4c50: 3e 5c 66 52 20 5c 66 42 72 65 73 65 74 5c 66 52  >\fR \fBreset\fR
4c60: 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 69 6e 76  .This method inv
4c70: 6f 6b 65 73 20 74 68 65 20 70 61 72 61 6d 65 74  okes the paramet
4c80: 65 72 20 6d 65 74 68 6f 64 20 5c 66 42 72 65 73  er method \fBres
4c90: 65 74 5c 66 52 20 6f 6e 20 61 6c 6c 0a 70 61 72  et\fR on all.par
4ca0: 61 6d 65 74 65 72 73 20 69 6e 20 74 68 65 20 63  ameters in the c
4cb0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 5c 26 2e 0a  onfiguration\&..
4cc0: 2e 54 50 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c  .TP.\fB<config>\
4cd0: 66 52 20 5c 66 42 73 65 6c 66 5c 66 52 0a 54 68  fR \fBself\fR.Th
4ce0: 69 73 20 6d 65 74 68 6f 64 20 72 65 74 75 72 6e  is method return
4cf0: 73 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74  s the configurat
4d00: 69 6f 6e 20 69 6e 73 74 61 6e 63 65 20 69 74 73  ion instance its
4d10: 65 6c 66 5c 26 2e 0a 2e 54 50 0a 5c 66 42 3c 63  elf\&...TP.\fB<c
4d20: 6f 6e 66 69 67 3e 5c 66 52 20 5c 66 42 74 6f 6f  onfig>\fR \fBtoo
4d30: 4d 61 6e 79 5c 66 52 0a 54 68 69 73 20 6d 65 74  Many\fR.This met
4d40: 68 6f 64 20 74 68 72 6f 77 73 20 74 68 65 20 73  hod throws the s
4d50: 74 61 6e 64 61 72 64 20 65 72 72 6f 72 20 66 6f  tandard error fo
4d60: 72 20 77 68 65 6e 20 61 20 63 6f 6d 6d 61 6e 64  r when a command
4d70: 20 69 73 20 66 6f 75 6e 64 0a 74 6f 20 62 65 20   is found.to be 
4d80: 73 75 70 70 6c 69 65 64 20 77 69 74 68 20 74 6f  supplied with to
4d90: 6f 20 6d 61 6e 79 20 61 72 67 75 6d 65 6e 74 73  o many arguments
4da0: 20 66 6f 72 20 69 74 73 20 70 61 72 61 6d 65 74   for its paramet
4db0: 65 72 73 5c 26 2e 20 53 65 65 20 74 68 65 0a 6d  ers\&. See the.m
4dc0: 65 74 68 6f 64 73 20 5c 66 42 6d 69 73 73 69 6e  ethods \fBmissin
4dd0: 67 4f 70 74 69 6f 6e 56 61 6c 75 65 5c 66 52 20  gOptionValue\fR 
4de0: 61 6e 64 20 5c 66 42 6e 6f 74 45 6e 6f 75 67 68  and \fBnotEnough
4df0: 5c 66 52 20 61 73 20 77 65 6c 6c 5c 26 2e 0a 2e  \fR as well\&...
4e00: 54 50 0a 5c 66 42 3c 63 6f 6e 66 69 67 3e 5c 66  TP.\fB<config>\f
4e10: 52 20 5c 66 42 75 6e 6b 6e 6f 77 6e 5c 66 52 20  R \fBunknown\fR 
4e20: 5c 66 49 6d 65 74 68 6f 64 5c 66 52 20 3f 5c 66  \fImethod\fR ?\f
4e30: 49 77 6f 72 64 5c 26 2e 5c 26 2e 5c 26 2e 5c 66  Iword\&.\&.\&.\f
4e40: 52 3f 0a 54 68 69 73 20 6d 65 74 68 6f 64 20 69  R?.This method i
4e50: 73 20 74 68 65 20 68 6f 6f 6b 20 69 6e 74 6f 20  s the hook into 
4e60: 74 68 65 20 54 63 6c 4f 4f 20 6d 65 74 68 6f 64  the TclOO method
4e70: 20 72 65 73 6f 6c 75 74 69 6f 6e 20 66 6f 72 20   resolution for 
4e80: 74 68 65 20 63 6c 61 73 73 5c 26 2e 0a 49 74 20  the class\&..It 
4e90: 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 64  implements the d
4ea0: 79 6e 61 6d 69 63 20 61 63 63 65 73 73 6f 72 20  ynamic accessor 
4eb0: 6d 65 74 68 6f 64 73 20 66 6f 72 20 74 68 65 20  methods for the 
4ec0: 70 61 72 61 6d 65 74 65 72 73 20 68 65 6c 64 20  parameters held 
4ed0: 62 79 0a 74 68 65 20 63 6f 6e 66 69 67 75 72 61  by.the configura
4ee0: 74 69 6f 6e 20 69 6e 73 74 61 6e 63 65 5c 26 2e  tion instance\&.
4ef0: 20 53 65 65 20 6d 65 74 68 6f 64 20 5c 66 42 40   See method \fB@
4f00: 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 20 61 74 20  \&.\&.\&.\fR at 
4f10: 74 68 65 20 74 6f 70 5c 26 2e 0a 2e 52 53 0a 2e  the top\&...RS..
4f20: 54 50 0a 6c 69 73 74 20 5c 66 49 6c 69 73 74 5c  TP.list \fIlist\
4f30: 66 52 0a 2e 52 45 0a 2e 50 50 0a 2e 53 48 20 22  fR..RE..PP..SH "
4f40: 48 45 4c 50 20 49 4e 46 4f 52 4d 41 54 49 4f 4e  HELP INFORMATION
4f50: 22 0a 54 68 65 20 68 65 6c 70 20 69 6e 66 6f 72  ".The help infor
4f60: 6d 61 74 69 6f 6e 20 67 65 6e 65 72 61 74 65 64  mation generated
4f70: 20 62 79 20 76 61 72 69 6f 75 73 20 70 6c 61 63   by various plac
4f80: 65 73 20 6f 66 20 74 68 65 20 66 72 61 6d 65 77  es of the framew
4f90: 6f 72 6b 0a 69 73 20 61 20 64 69 63 74 69 6f 6e  ork.is a diction
4fa0: 61 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74  ary containing t
4fb0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6b 65 79  he following key
4fc0: 73 3a 0a 2e 54 50 0a 61 72 67 75 6d 65 6e 74 73  s:..TP.arguments
4fd0: 0a 41 20 6c 69 73 74 20 6f 66 20 73 74 72 69 6e  .A list of strin
4fe0: 67 73 2c 20 74 68 65 20 6e 61 6d 65 73 20 6f 66  gs, the names of
4ff0: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 72 67   the command arg
5000: 75 6d 65 6e 74 73 2c 20 69 6e 20 6f 72 64 65 72  uments, in order
5010: 5c 26 2e 0a 54 68 65 73 65 20 6e 61 6d 65 73 20  \&..These names 
5020: 61 72 65 20 6b 65 79 73 20 69 6e 74 6f 20 74 68  are keys into th
5030: 65 20 5c 66 42 70 61 72 61 6d 65 74 65 72 73 5c  e \fBparameters\
5040: 66 52 20 73 75 62 2d 64 69 63 74 69 6f 6e 61 72  fR sub-dictionar
5050: 79 5c 26 2e 0a 2e 54 50 0a 64 65 73 63 0a 54 68  y\&...TP.desc.Th
5060: 65 20 63 6f 6d 6d 61 6e 64 27 73 20 64 65 73 63  e command's desc
5070: 72 69 70 74 69 6f 6e 2c 20 69 5c 26 2e 65 5c 26  ription, i\&.e\&
5080: 2e 20 68 65 6c 70 20 74 65 78 74 5c 26 2e 0a 2e  . help text\&...
5090: 54 50 0a 6f 70 74 32 70 61 72 61 0a 41 20 64 69  TP.opt2para.A di
50a0: 63 74 69 6f 6e 61 72 79 20 6d 61 70 70 69 6e 67  ctionary mapping
50b0: 20 6f 70 74 69 6f 6e 20 66 6c 61 67 73 20 74 6f   option flags to
50c0: 20 6f 70 74 69 6f 6e 20 6e 61 6d 65 73 5c 26 2e   option names\&.
50d0: 0a 54 68 65 73 65 20 6e 61 6d 65 73 20 61 72 65  .These names are
50e0: 20 6b 65 79 73 20 69 6e 74 6f 20 74 68 65 20 5c   keys into the \
50f0: 66 42 70 61 72 61 6d 65 74 65 72 73 5c 66 52 20  fBparameters\fR 
5100: 73 75 62 2d 64 69 63 74 69 6f 6e 61 72 79 5c 26  sub-dictionary\&
5110: 2e 0a 2e 54 50 0a 6f 70 74 69 6f 6e 73 0a 41 20  ...TP.options.A 
5120: 64 69 63 74 69 6f 6e 61 72 79 20 6d 61 70 70 69  dictionary mappi
5130: 6e 67 20 6f 70 74 69 6f 6e 20 6e 61 6d 65 73 20  ng option names 
5140: 74 6f 20 74 68 65 69 72 20 64 65 73 63 72 69 70  to their descrip
5150: 74 69 6f 6e 73 5c 26 2e 0a 2e 54 50 0a 70 61 72  tions\&...TP.par
5160: 61 6d 65 74 65 72 73 0a 41 20 64 69 63 74 69 6f  ameters.A dictio
5170: 6e 61 72 79 20 6d 61 70 70 69 6e 67 20 70 61 72  nary mapping par
5180: 61 6d 65 74 65 72 20 6e 61 6d 65 73 20 74 6f 20  ameter names to 
5190: 74 68 65 69 72 20 64 65 66 69 6e 69 74 69 6f 6e  their definition
51a0: 5c 26 2e 0a 45 61 63 68 20 64 65 66 69 6e 69 74  \&..Each definit
51b0: 69 6f 6e 20 69 73 20 61 20 64 69 63 74 69 6f 6e  ion is a diction
51c0: 61 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74  ary containing t
51d0: 68 65 20 6b 65 79 73 20 62 65 6c 6f 77 5c 26 2e  he keys below\&.
51e0: 0a 53 65 65 20 61 6c 73 6f 20 70 61 63 6b 61 67  .See also packag
51f0: 65 20 5c 66 42 63 6d 64 72 3a 3a 70 61 72 61 6d  e \fBcmdr::param
5200: 65 74 65 72 5c 66 52 5c 26 2e 0a 2e 52 53 0a 2e  eter\fR\&...RS..
5210: 54 50 0a 63 6d 64 6c 69 6e 65 0a 4f 75 74 70 75  TP.cmdline.Outpu
5220: 74 20 6f 66 20 6d 65 74 68 6f 64 20 5c 66 42 63  t of method \fBc
5230: 6d 64 6c 69 6e 65 5c 66 52 5c 26 2e 0a 2e 54 50  mdline\fR\&...TP
5240: 0a 63 6f 64 65 0a 4f 75 74 70 75 74 20 6f 66 20  .code.Output of 
5250: 6d 65 74 68 6f 64 20 5c 66 42 63 6f 64 65 5c 66  method \fBcode\f
5260: 52 5c 26 2e 0a 2e 54 50 0a 64 65 66 61 75 6c 74  R\&...TP.default
5270: 0a 4f 75 74 70 75 74 20 6f 66 20 6d 65 74 68 6f  .Output of metho
5280: 64 20 5c 66 42 64 65 66 61 75 6c 74 5c 66 52 5c  d \fBdefault\fR\
5290: 26 2e 0a 2e 54 50 0a 64 65 66 65 72 65 64 0a 4f  &...TP.defered.O
52a0: 75 74 70 75 74 20 6f 66 20 6d 65 74 68 6f 64 20  utput of method 
52b0: 5c 66 42 64 65 66 65 72 65 64 5c 66 52 5c 26 2e  \fBdefered\fR\&.
52c0: 0a 2e 54 50 0a 64 65 73 63 72 69 70 74 69 6f 6e  ..TP.description
52d0: 0a 4f 75 74 70 75 74 20 6f 66 20 6d 65 74 68 6f  .Output of metho
52e0: 64 20 5c 66 42 64 65 73 63 72 69 70 74 69 6f 6e  d \fBdescription
52f0: 5c 66 52 5c 26 2e 0a 2e 54 50 0a 64 6f 63 75 6d  \fR\&...TP.docum
5300: 65 6e 74 65 64 0a 4f 75 74 70 75 74 20 6f 66 20  ented.Output of 
5310: 6d 65 74 68 6f 64 20 5c 66 42 64 6f 63 75 6d 65  method \fBdocume
5320: 6e 74 65 64 5c 66 52 5c 26 2e 0a 2e 54 50 0a 66  nted\fR\&...TP.f
5330: 6c 61 67 73 0a 41 20 64 69 63 74 69 6f 6e 61 72  lags.A dictionar
5340: 79 20 6d 61 70 70 69 6e 67 20 66 6c 61 67 20 6e  y mapping flag n
5350: 61 6d 65 73 20 74 6f 20 66 6c 61 67 0a 74 79 70  ames to flag.typ
5360: 65 73 2c 20 69 5c 26 2e 65 5c 26 2e 20 5c 66 42  es, i\&.e\&. \fB
5370: 70 72 69 6d 61 72 79 5c 66 52 2c 20 5c 66 42 61  primary\fR, \fBa
5380: 6c 69 61 73 5c 66 52 2c 0a 6f 72 20 5c 66 42 69  lias\fR,.or \fBi
5390: 6e 76 65 72 74 65 64 5c 66 52 5c 26 2e 0a 2e 54  nverted\fR\&...T
53a0: 50 0a 67 65 6e 65 72 61 74 6f 72 0a 4f 75 74 70  P.generator.Outp
53b0: 75 74 20 6f 66 20 6d 65 74 68 6f 64 20 5c 66 42  ut of method \fB
53c0: 67 65 6e 65 72 61 74 6f 72 5c 66 52 5c 26 2e 0a  generator\fR\&..
53d0: 2e 54 50 0a 69 6e 74 65 72 61 63 74 69 76 65 0a  .TP.interactive.
53e0: 4f 75 74 70 75 74 20 6f 66 20 6d 65 74 68 6f 64  Output of method
53f0: 20 5c 66 42 69 6e 74 65 72 61 63 74 69 76 65 5c   \fBinteractive\
5400: 66 52 5c 26 2e 0a 2e 54 50 0a 69 73 62 6f 6f 6c  fR\&...TP.isbool
5410: 0a 4f 75 74 70 75 74 20 6f 66 20 6d 65 74 68 6f  .Output of metho
5420: 64 20 5c 66 42 69 73 62 6f 6f 6c 5c 66 52 5c 26  d \fBisbool\fR\&
5430: 2e 0a 2e 54 50 0a 6c 61 62 65 6c 0a 4f 75 74 70  ...TP.label.Outp
5440: 75 74 20 6f 66 20 6d 65 74 68 6f 64 20 5c 66 42  ut of method \fB
5450: 6c 61 62 65 6c 5c 66 52 5c 26 2e 0a 2e 54 50 0a  label\fR\&...TP.
5460: 6c 69 73 74 0a 4f 75 74 70 75 74 20 6f 66 20 6d  list.Output of m
5470: 65 74 68 6f 64 20 5c 66 42 6c 69 73 74 5c 66 52  ethod \fBlist\fR
5480: 5c 26 2e 0a 2e 54 50 0a 6f 72 64 65 72 65 64 0a  \&...TP.ordered.
5490: 4f 75 74 70 75 74 20 6f 66 20 6d 65 74 68 6f 64  Output of method
54a0: 20 5c 66 42 6f 72 64 65 72 65 64 5c 66 52 5c 26   \fBordered\fR\&
54b0: 2e 0a 2e 54 50 0a 70 72 65 73 65 6e 63 65 0a 4f  ...TP.presence.O
54c0: 75 74 70 75 74 20 6f 66 20 6d 65 74 68 6f 64 20  utput of method 
54d0: 5c 66 42 70 72 65 73 65 6e 63 65 5c 66 52 5c 26  \fBpresence\fR\&
54e0: 2e 0a 2e 54 50 0a 70 72 6f 6d 70 74 0a 4f 75 74  ...TP.prompt.Out
54f0: 70 75 74 20 6f 66 20 6d 65 74 68 6f 64 20 5c 66  put of method \f
5500: 42 70 72 6f 6d 70 74 5c 66 52 5c 26 2e 0a 2e 54  Bprompt\fR\&...T
5510: 50 0a 72 65 71 75 69 72 65 64 0a 4f 75 74 70 75  P.required.Outpu
5520: 74 20 6f 66 20 6d 65 74 68 6f 64 20 5c 66 42 72  t of method \fBr
5530: 65 71 75 69 72 65 64 5c 66 52 5c 26 2e 0a 2e 54  equired\fR\&...T
5540: 50 0a 74 68 72 65 73 68 6f 6c 64 0a 4f 75 74 70  P.threshold.Outp
5550: 75 74 20 6f 66 20 6d 65 74 68 6f 64 20 5c 66 42  ut of method \fB
5560: 74 68 72 65 73 68 6f 6c 64 5c 66 52 5c 26 2e 0a  threshold\fR\&..
5570: 2e 54 50 0a 74 79 70 65 0a 4f 75 74 70 75 74 20  .TP.type.Output 
5580: 6f 66 20 6d 65 74 68 6f 64 20 5c 66 42 74 79 70  of method \fBtyp
5590: 65 5c 66 52 5c 26 2e 0a 2e 54 50 0a 76 61 6c 69  e\fR\&...TP.vali
55a0: 64 61 74 6f 72 0a 4f 75 74 70 75 74 20 6f 66 20  dator.Output of 
55b0: 6d 65 74 68 6f 64 20 5c 66 42 76 61 6c 69 64 61  method \fBvalida
55c0: 74 6f 72 5c 66 52 5c 26 2e 0a 2e 52 45 0a 2e 54  tor\fR\&...RE..T
55d0: 50 0a 73 65 63 74 69 6f 6e 73 0a 41 20 6c 69 73  P.sections.A lis
55e0: 74 20 6f 66 20 73 65 63 74 69 6f 6e 73 20 74 68  t of sections th
55f0: 65 20 63 6f 6d 6d 61 6e 64 20 62 65 6c 6f 6e 67  e command belong
5600: 73 20 74 6f 5c 26 2e 0a 45 61 63 68 20 73 65 63  s to\&..Each sec
5610: 74 69 6f 6e 20 6e 61 6d 65 20 69 73 20 61 20 6c  tion name is a l
5620: 69 73 74 20 69 74 73 65 6c 66 2c 20 74 68 65 20  ist itself, the 
5630: 70 61 74 68 20 6f 66 20 74 68 65 20 73 65 63 74  path of the sect
5640: 69 6f 6e 20 61 6e 64 20 73 75 62 2d 73 65 63 74  ion and sub-sect
5650: 69 6f 6e 73 5c 26 2e 0a 2e 54 50 0a 73 74 61 74  ions\&...TP.stat
5660: 65 73 0a 41 20 6c 69 73 74 20 6f 66 20 73 74 72  es.A list of str
5670: 69 6e 67 73 2c 20 74 68 65 20 6e 61 6d 65 73 20  ings, the names 
5680: 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 27 73  of the command's
5690: 20 68 69 64 64 65 6e 20 73 74 61 74 65 20 70 61   hidden state pa
56a0: 72 61 6d 65 74 65 72 73 5c 26 2e 0a 54 68 65 73  rameters\&..Thes
56b0: 65 20 6e 61 6d 65 73 20 61 72 65 20 6b 65 79 73  e names are keys
56c0: 20 69 6e 74 6f 20 74 68 65 20 5c 66 42 70 61 72   into the \fBpar
56d0: 61 6d 65 74 65 72 73 5c 66 52 20 73 75 62 2d 64  ameters\fR sub-d
56e0: 69 63 74 69 6f 6e 61 72 79 5c 26 2e 0a 2e 50 50  ictionary\&...PP
56f0: 0a 2e 53 48 20 22 42 55 47 53 2c 20 49 44 45 41  ..SH "BUGS, IDEA
5700: 53 2c 20 46 45 45 44 42 41 43 4b 22 0a 42 6f 74  S, FEEDBACK".Bot
5710: 68 20 74 68 65 20 70 61 63 6b 61 67 65 28 73 29  h the package(s)
5720: 20 61 6e 64 20 74 68 69 73 20 64 6f 63 75 6d 65   and this docume
5730: 6e 74 61 74 69 6f 6e 20 77 69 6c 6c 20 75 6e 64  ntation will und
5740: 6f 75 62 74 65 64 6c 79 20 63 6f 6e 74 61 69 6e  oubtedly contain
5750: 0a 62 75 67 73 20 61 6e 64 20 6f 74 68 65 72 20  .bugs and other 
5760: 70 72 6f 62 6c 65 6d 73 5c 26 2e 0a 50 6c 65 61  problems\&..Plea
5770: 73 65 20 72 65 70 6f 72 74 20 73 75 63 68 20 61  se report such a
5780: 74 0a 5c 66 49 43 6d 64 72 20 54 69 63 6b 65 74  t.\fICmdr Ticket
5790: 73 5c 66 52 20 5b 68 74 74 70 73 3a 2f 63 6f 72  s\fR [https:/cor
57a0: 65 5c 26 2e 74 63 6c 5c 26 2e 74 6b 2f 61 6b 75  e\&.tcl\&.tk/aku
57b0: 70 72 69 65 73 2f 63 6d 64 72 5d 5c 26 2e 0a 2e  pries/cmdr]\&...
57c0: 50 50 0a 50 6c 65 61 73 65 20 61 6c 73 6f 20 72  PP.Please also r
57d0: 65 70 6f 72 74 20 61 6e 79 20 69 64 65 61 73 20  eport any ideas 
57e0: 79 6f 75 20 6d 61 79 20 68 61 76 65 20 66 6f 72  you may have for
57f0: 20 65 6e 68 61 6e 63 65 6d 65 6e 74 73 20 6f 66   enhancements of
5800: 0a 65 69 74 68 65 72 20 70 61 63 6b 61 67 65 28  .either package(
5810: 73 29 20 61 6e 64 2f 6f 72 20 64 6f 63 75 6d 65  s) and/or docume
5820: 6e 74 61 74 69 6f 6e 5c 26 2e 0a 2e 53 48 20 4b  ntation\&...SH K
5830: 45 59 57 4f 52 44 53 0a 61 72 67 75 6d 65 6e 74  EYWORDS.argument
5840: 73 2c 20 63 6f 6d 6d 61 6e 64 20 68 69 65 72 61  s, command hiera
5850: 72 63 68 79 2c 20 63 6f 6d 6d 61 6e 64 20 6c 69  rchy, command li
5860: 6e 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 63  ne completion, c
5870: 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 68 61 6e 64  ommand line hand
5880: 6c 69 6e 67 2c 20 63 6f 6d 6d 61 6e 64 20 74 72  ling, command tr
5890: 65 65 2c 20 65 64 69 74 69 6e 67 20 63 6f 6d 6d  ee, editing comm
58a0: 61 6e 64 20 6c 69 6e 65 2c 20 68 65 6c 70 20 66  and line, help f
58b0: 6f 72 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2c  or command line,
58c0: 20 68 69 65 72 61 72 63 68 79 20 6f 66 20 63 6f   hierarchy of co
58d0: 6d 6d 61 6e 64 73 2c 20 69 6e 74 65 72 61 63 74  mmands, interact
58e0: 69 76 65 20 63 6f 6d 6d 61 6e 64 20 73 68 65 6c  ive command shel
58f0: 6c 2c 20 6f 70 74 69 6f 6e 61 6c 20 61 72 67 75  l, optional argu
5900: 6d 65 6e 74 73 2c 20 6f 70 74 69 6f 6e 73 2c 20  ments, options, 
5910: 70 61 72 61 6d 65 74 65 72 73 2c 20 70 72 6f 63  parameters, proc
5920: 65 73 73 69 6e 67 20 63 6f 6d 6d 61 6e 64 20 6c  essing command l
5930: 69 6e 65 2c 20 74 72 65 65 20 6f 66 20 63 6f 6d  ine, tree of com
5940: 6d 61 6e 64 73 0a 2e 53 48 20 43 4f 50 59 52 49  mands..SH COPYRI
5950: 47 48 54 0a 2e 6e 66 0a 43 6f 70 79 72 69 67 68  GHT..nf.Copyrigh
5960: 74 20 28 63 29 20 32 30 31 33 2d 32 30 31 36 20  t (c) 2013-2016 
5970: 41 6e 64 72 65 61 73 20 4b 75 70 72 69 65 73 0a  Andreas Kupries.
5980: 43 6f 70 79 72 69 67 68 74 20 28 63 29 20 32 30  Copyright (c) 20
5990: 31 33 2d 32 30 31 36 20 44 6f 63 75 6d 65 6e 74  13-2016 Document
59a0: 61 74 69 6f 6e 2c 20 41 6e 64 72 65 61 73 20 4b  ation, Andreas K
59b0: 75 70 72 69 65 73 0a 0a 2e 66 69                 upries...fi