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

Artifact 1fdbdf0d6aa23405651f30ee97eaf33dd00aae3a:


0000: 23 23 20 2d 2a 2d 20 74 63 6c 20 2d 2a 2d 0a 23  ## -*- tcl -*-.#
0010: 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20   # ## ### ##### 
0020: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
0030: 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23  ###### #########
0040: 23 23 23 23 23 23 23 23 23 23 23 23 0a 23 23 20  ############.## 
0050: 43 4d 44 52 20 2d 20 4f 66 66 69 63 65 72 20 2d  CMDR - Officer -
0060: 20 43 6f 6d 6d 61 6e 64 20 65 78 65 63 75 74 69   Command executi
0070: 6f 6e 2e 20 44 69 73 70 61 74 63 68 65 72 2e 0a  on. Dispatcher..
0080: 23 23 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ##              
0090: 20 20 41 6e 20 61 63 74 6f 72 2e 0a 0a 23 23 20    An actor...## 
00a0: 2d 20 4f 66 66 69 63 65 72 73 20 63 61 6e 20 6c  - Officers can l
00b0: 65 61 72 6e 20 74 6f 20 64 6f 20 6d 61 6e 79 20  earn to do many 
00c0: 74 68 69 6e 67 73 2c 20 62 79 20 64 65 6c 65 67  things, by deleg
00d0: 61 74 69 6e 67 20 74 68 69 6e 67 73 20 74 6f 20  ating things to 
00e0: 74 68 65 0a 23 23 20 20 20 70 72 69 76 61 74 65  the.##   private
00f0: 73 20 61 63 74 75 61 6c 6c 79 20 61 62 6c 65 20  s actually able 
0100: 74 6f 20 70 65 72 66 6f 72 6d 20 69 74 2e 0a 0a  to perform it...
0110: 23 20 40 40 20 4d 65 74 61 20 42 65 67 69 6e 0a  # @@ Meta Begin.
0120: 23 20 50 61 63 6b 61 67 65 20 63 6d 64 72 3a 3a  # Package cmdr::
0130: 6f 66 66 69 63 65 72 20 30 0a 23 20 4d 65 74 61  officer 0.# Meta
0140: 20 61 75 74 68 6f 72 20 20 20 7b 41 6e 64 72 65   author   {Andre
0150: 61 73 20 4b 75 70 72 69 65 73 7d 0a 23 20 4d 65  as Kupries}.# Me
0160: 74 61 20 6c 6f 63 61 74 69 6f 6e 20 68 74 74 70  ta location http
0170: 73 3a 2f 2f 63 6f 72 65 2e 74 63 6c 2e 74 6b 2f  s://core.tcl.tk/
0180: 61 6b 75 70 72 69 65 73 2f 63 6d 64 72 0a 23 20  akupries/cmdr.# 
0190: 4d 65 74 61 20 70 6c 61 74 66 6f 72 6d 20 74 63  Meta platform tc
01a0: 6c 0a 23 20 4d 65 74 61 20 73 75 6d 6d 61 72 79  l.# Meta summary
01b0: 20 41 67 67 72 65 67 61 74 69 6f 6e 20 6f 66 20   Aggregation of 
01c0: 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 61 6e 64  multiple command
01d0: 73 20 66 6f 72 20 64 69 73 70 61 74 63 68 2e 0a  s for dispatch..
01e0: 23 20 4d 65 74 61 20 64 65 73 63 72 69 70 74 69  # Meta descripti
01f0: 6f 6e 20 27 63 6d 64 72 3a 3a 6f 66 66 69 63 65  on 'cmdr::office
0200: 72 27 73 20 63 61 6e 20 6c 65 61 72 6e 20 74 6f  r's can learn to
0210: 20 64 6f 20 6d 61 6e 79 20 74 68 69 6e 67 73 2c   do many things,
0220: 0a 23 20 4d 65 74 61 20 64 65 73 63 72 69 70 74  .# Meta descript
0230: 69 6f 6e 20 62 79 20 64 65 6c 65 67 61 74 69 6e  ion by delegatin
0240: 67 20 74 68 69 6e 67 73 20 74 6f 20 74 68 65 20  g things to the 
0250: 27 63 6d 64 72 3a 3a 70 72 69 76 61 74 65 27 73  'cmdr::private's
0260: 0a 23 20 4d 65 74 61 20 64 65 73 63 72 69 70 74  .# Meta descript
0270: 69 6f 6e 20 61 63 74 75 61 6c 6c 79 20 61 62 6c  ion actually abl
0280: 65 20 74 6f 20 70 65 72 66 6f 72 6d 20 69 74 2e  e to perform it.
0290: 0a 23 20 4d 65 74 61 20 73 75 62 6a 65 63 74 20  .# Meta subject 
02a0: 7b 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 7d 20 64  {command line} d
02b0: 65 6c 65 67 61 74 69 6f 6e 20 64 69 73 70 61 74  elegation dispat
02c0: 63 68 0a 23 20 4d 65 74 61 20 72 65 71 75 69 72  ch.# Meta requir
02d0: 65 20 54 63 6c 4f 4f 0a 23 20 4d 65 74 61 20 72  e TclOO.# Meta r
02e0: 65 71 75 69 72 65 20 63 6d 64 72 3a 3a 61 63 74  equire cmdr::act
02f0: 6f 72 0a 23 20 4d 65 74 61 20 72 65 71 75 69 72  or.# Meta requir
0300: 65 20 63 6d 64 72 3a 3a 68 65 6c 70 0a 23 20 4d  e cmdr::help.# M
0310: 65 74 61 20 72 65 71 75 69 72 65 20 63 6d 64 72  eta require cmdr
0320: 3a 3a 70 72 69 76 61 74 65 0a 23 20 4d 65 74 61  ::private.# Meta
0330: 20 72 65 71 75 69 72 65 20 64 65 62 75 67 0a 23   require debug.#
0340: 20 4d 65 74 61 20 72 65 71 75 69 72 65 20 64 65   Meta require de
0350: 62 75 67 3a 3a 63 61 6c 6c 65 72 0a 23 20 4d 65  bug::caller.# Me
0360: 74 61 20 72 65 71 75 69 72 65 20 6c 69 6e 65 6e  ta require linen
0370: 6f 69 73 65 3a 3a 66 61 63 61 64 65 0a 23 20 4d  oise::facade.# M
0380: 65 74 61 20 72 65 71 75 69 72 65 20 74 72 79 0a  eta require try.
0390: 23 20 4d 65 74 61 20 72 65 71 75 69 72 65 20 7b  # Meta require {
03a0: 54 63 6c 20 38 2e 35 2d 7d 0a 23 20 4d 65 74 61  Tcl 8.5-}.# Meta
03b0: 20 72 65 71 75 69 72 65 20 7b 6f 6f 3a 3a 75 74   require {oo::ut
03c0: 69 6c 20 31 2e 32 7d 0a 23 20 4d 65 74 61 20 72  il 1.2}.# Meta r
03d0: 65 71 75 69 72 65 20 7b 73 74 72 69 6e 67 3a 3a  equire {string::
03e0: 74 6f 6b 65 6e 3a 3a 73 68 65 6c 6c 20 31 2e 31  token::shell 1.1
03f0: 7d 0a 23 20 40 40 20 4d 65 74 61 20 45 6e 64 0a  }.# @@ Meta End.
0400: 0a 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23  .# # ## ### ####
0410: 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23  # ######## #####
0420: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
0430: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a 23  ##############.#
0440: 23 20 52 65 71 75 69 73 69 74 65 73 0a 0a 70 61  # Requisites..pa
0450: 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 54 63  ckage require Tc
0460: 6c 20 38 2e 35 0a 70 61 63 6b 61 67 65 20 72 65  l 8.5.package re
0470: 71 75 69 72 65 20 64 65 62 75 67 0a 70 61 63 6b  quire debug.pack
0480: 61 67 65 20 72 65 71 75 69 72 65 20 64 65 62 75  age require debu
0490: 67 3a 3a 63 61 6c 6c 65 72 0a 70 61 63 6b 61 67  g::caller.packag
04a0: 65 20 72 65 71 75 69 72 65 20 6c 69 6e 65 6e 6f  e require lineno
04b0: 69 73 65 3a 3a 66 61 63 61 64 65 0a 70 61 63 6b  ise::facade.pack
04c0: 61 67 65 20 72 65 71 75 69 72 65 20 73 74 72 69  age require stri
04d0: 6e 67 3a 3a 74 6f 6b 65 6e 3a 3a 73 68 65 6c 6c  ng::token::shell
04e0: 20 31 2e 31 0a 70 61 63 6b 61 67 65 20 72 65 71   1.1.package req
04f0: 75 69 72 65 20 74 72 79 0a 70 61 63 6b 61 67 65  uire try.package
0500: 20 72 65 71 75 69 72 65 20 54 63 6c 4f 4f 0a 70   require TclOO.p
0510: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 6f  ackage require o
0520: 6f 3a 3a 75 74 69 6c 20 31 2e 32 20 3b 23 20 6c  o::util 1.2 ;# l
0530: 69 6e 6b 20 68 65 6c 70 65 72 2e 0a 70 61 63 6b  ink helper..pack
0540: 61 67 65 20 72 65 71 75 69 72 65 20 63 6d 64 72  age require cmdr
0550: 3a 3a 61 63 74 6f 72 0a 70 61 63 6b 61 67 65 20  ::actor.package 
0560: 72 65 71 75 69 72 65 20 63 6d 64 72 3a 3a 70 72  require cmdr::pr
0570: 69 76 61 74 65 0a 70 61 63 6b 61 67 65 20 72 65  ivate.package re
0580: 71 75 69 72 65 20 63 6d 64 72 3a 3a 68 65 6c 70  quire cmdr::help
0590: 0a 0a 23 20 23 20 23 23 20 23 23 23 20 23 23 23  ..# # ## ### ###
05a0: 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23  ## ######## ####
05b0: 23 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23  ######### ######
05c0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  ###############.
05d0: 0a 64 65 62 75 67 20 64 65 66 69 6e 65 20 63 6d  .debug define cm
05e0: 64 72 2f 6f 66 66 69 63 65 72 0a 64 65 62 75 67  dr/officer.debug
05f0: 20 6c 65 76 65 6c 20 20 63 6d 64 72 2f 6f 66 66   level  cmdr/off
0600: 69 63 65 72 0a 64 65 62 75 67 20 70 72 65 66 69  icer.debug prefi
0610: 78 20 63 6d 64 72 2f 6f 66 66 69 63 65 72 20 7b  x cmdr/officer {
0620: 5b 64 65 62 75 67 20 63 61 6c 6c 65 72 5d 20 7c  [debug caller] |
0630: 20 7d 0a 0a 23 20 23 20 23 23 20 23 23 23 20 23   }..# # ## ### #
0640: 23 23 23 23 20 23 23 23 23 23 23 23 23 20 23 23  #### ######## ##
0650: 23 23 23 23 23 23 23 23 23 23 23 20 23 23 23 23  ########### ####
0660: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0670: 23 0a 23 23 20 44 65 66 69 6e 69 74 69 6f 6e 20  #.## Definition 
0680: 2d 20 53 69 6e 67 6c 65 20 70 75 72 70 6f 73 65  - Single purpose
0690: 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 23 20 23 20 23   command...# # #
06a0: 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23  # ### ##### ####
06b0: 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23  #### ###########
06c0: 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23  ## #############
06d0: 23 23 23 23 23 23 23 23 0a 23 23 20 44 65 66 69  ########.## Defi
06e0: 6e 69 74 69 6f 6e 0a 0a 6f 6f 3a 3a 63 6c 61 73  nition..oo::clas
06f0: 73 20 63 72 65 61 74 65 20 3a 3a 63 6d 64 72 3a  s create ::cmdr:
0700: 3a 6f 66 66 69 63 65 72 20 7b 0a 20 20 20 20 73  :officer {.    s
0710: 75 70 65 72 63 6c 61 73 73 20 3a 3a 63 6d 64 72  uperclass ::cmdr
0720: 3a 3a 61 63 74 6f 72 0a 20 20 20 20 23 20 23 20  ::actor.    # # 
0730: 23 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23  ## ### ##### ###
0740: 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23  ##### ##########
0750: 23 23 23 0a 20 20 20 20 23 23 20 4c 69 66 65 63  ###.    ## Lifec
0760: 79 63 6c 65 2e 0a 0a 20 20 20 20 23 20 61 63 74  ycle...    # act
0770: 69 6f 6e 20 73 70 65 63 69 66 69 63 61 74 69 6f  ion specificatio
0780: 6e 2e 0a 20 20 20 20 23 20 64 65 63 6c 61 72 65  n..    # declare
0790: 73 20 61 20 68 69 65 72 61 72 63 68 79 20 6f 66  s a hierarchy of
07a0: 20 73 75 62 2d 6f 72 64 69 6e 61 74 65 20 6f 66   sub-ordinate of
07b0: 66 69 63 65 72 73 20 61 6e 64 20 70 72 69 76 61  ficers and priva
07c0: 74 65 73 2e 0a 0a 20 20 20 20 23 20 53 70 65 63  tes...    # Spec
07d0: 69 66 69 63 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e  ification comman
07e0: 64 73 2e 0a 20 20 20 20 23 0a 20 20 20 20 23 20  ds..    #.    # 
07f0: 70 72 69 76 61 74 65 20 24 6e 61 6d 65 20 24 61  private $name $a
0800: 72 67 75 6d 65 6e 74 73 20 24 63 6d 64 70 72 65  rguments $cmdpre
0810: 66 69 78 20 2d 2d 3e 20 73 75 62 2d 6f 72 64 69  fix --> sub-ordi
0820: 6e 61 74 65 20 70 72 69 76 61 74 65 20 66 6f 72  nate private for
0830: 20 74 68 65 20 61 63 74 69 6f 6e 2e 0a 20 20 20   the action..   
0840: 20 23 20 6f 66 66 69 63 65 72 20 24 6e 61 6d 65   # officer $name
0850: 20 24 61 63 74 69 6f 6e 73 20 20 20 20 20 20 20   $actions       
0860: 20 20 20 20 20 20 20 2d 2d 3e 20 73 75 62 2d 6f         --> sub-o
0870: 72 64 69 6e 61 74 65 20 6f 66 66 69 63 65 72 20  rdinate officer 
0880: 77 69 74 68 20 6d 6f 72 65 20 61 63 74 69 6f 6e  with more action
0890: 73 2e 0a 20 20 20 20 23 20 64 65 66 61 75 6c 74  s..    # default
08a0: 20 24 6e 61 6d 65 20 20 20 20 20 20 20 20 20 20   $name          
08b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 2d 3e               -->
08c0: 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 0a   default action.
08d0: 0a 20 20 20 20 63 6f 6e 73 74 72 75 63 74 6f 72  .    constructor
08e0: 20 7b 73 75 70 65 72 20 6e 61 6d 65 20 61 63 74   {super name act
08f0: 69 6f 6e 73 7d 20 7b 0a 09 64 65 62 75 67 2e 63  ions} {..debug.c
0900: 6d 64 72 2f 6f 66 66 69 63 65 72 20 7b 7d 0a 09  mdr/officer {}..
0910: 6e 65 78 74 0a 0a 09 6d 79 20 73 75 70 65 72 3a  next...my super:
0920: 20 24 73 75 70 65 72 0a 09 6d 79 20 6e 61 6d 65   $super..my name
0930: 3a 20 20 24 6e 61 6d 65 0a 0a 09 73 65 74 20 6d  :  $name...set m
0940: 79 61 63 74 69 6f 6e 73 20 20 20 24 61 63 74 69  yactions   $acti
0950: 6f 6e 73 20 3b 20 23 20 41 63 74 69 6f 6e 20 73  ons ; # Action s
0960: 70 65 63 20 66 6f 72 20 66 75 74 75 72 65 20 69  pec for future i
0970: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 0a 09 73  nitialization..s
0980: 65 74 20 6d 79 69 6e 69 74 20 20 20 20 20 20 6e  et myinit      n
0990: 6f 20 20 20 20 20 20 20 3b 20 23 20 44 69 73 70  o       ; # Disp
09a0: 61 74 63 68 20 6d 61 70 20 77 69 6c 6c 20 62 65  atch map will be
09b0: 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 6c 61 7a   initialized laz
09c0: 69 6c 79 0a 09 73 65 74 20 6d 79 6d 61 70 20 20  ily..set mymap  
09d0: 20 20 20 20 20 7b 7d 20 20 20 20 20 20 20 3b 20       {}       ; 
09e0: 23 20 41 63 74 69 6f 6e 20 6d 61 70 20 73 74 61  # Action map sta
09f0: 72 74 73 20 6b 6e 6f 77 69 6e 67 20 6e 6f 74 68  rts knowing noth
0a00: 69 6e 67 0a 09 73 65 74 20 6d 79 63 6f 6d 6d 61  ing..set mycomma
0a10: 6e 64 73 20 20 7b 7d 20 20 20 20 20 20 20 3b 20  nds  {}       ; 
0a20: 23 20 44 69 74 74 6f 0a 09 73 65 74 20 6d 79 63  # Ditto..set myc
0a30: 63 6f 6d 6d 61 6e 64 73 20 7b 7d 20 20 20 20 20  commands {}     
0a40: 20 20 3b 20 23 20 44 69 74 74 6f 2c 20 64 65 72    ; # Ditto, der
0a50: 69 76 65 64 20 63 61 63 68 65 2c 20 73 65 65 20  ived cache, see 
0a60: 6d 65 74 68 6f 64 20 43 43 6f 6d 6d 61 6e 64 73  method CCommands
0a70: 2e 0a 09 73 65 74 20 6d 79 63 68 69 6c 64 72 65  ...set mychildre
0a80: 6e 20 20 7b 7d 20 20 20 20 20 20 20 3b 20 23 20  n  {}       ; # 
0a90: 4c 69 73 74 20 6f 66 20 63 72 65 61 74 65 64 20  List of created 
0aa0: 73 75 62 6f 72 64 69 6e 61 74 65 73 2e 0a 09 73  subordinates...s
0ab0: 65 74 20 6d 79 68 61 6e 64 6c 65 72 20 20 20 7b  et myhandler   {
0ac0: 7d 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a  }..return.    }.
0ad0: 0a 20 20 20 20 23 20 23 20 23 23 20 23 23 23 20  .    # # ## ### 
0ae0: 23 23 23 23 23 20 23 23 23 23 23 23 23 23 20 23  ##### ######## #
0af0: 23 23 23 23 23 23 23 23 23 23 23 23 0a 0a 20 20  ############..  
0b00: 20 20 6d 65 74 68 6f 64 20 65 68 61 6e 64 6c 65    method ehandle
0b10: 72 20 7b 63 6d 64 7d 20 7b 0a 09 64 65 62 75 67  r {cmd} {..debug
0b20: 2e 63 6d 64 72 2f 6f 66 66 69 63 65 72 20 7b 7d  .cmdr/officer {}
0b30: 0a 09 73 65 74 20 6d 79 68 61 6e 64 6c 65 72 20  ..set myhandler 
0b40: 24 63 6d 64 0a 09 72 65 74 75 72 6e 0a 20 20 20  $cmd..return.   
0b50: 20 7d 0a 0a 20 20 20 20 23 20 23 20 23 23 20 23   }..    # # ## #
0b60: 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23 23  ## ##### #######
0b70: 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  # #############.
0b80: 20 20 20 20 23 23 20 50 75 62 6c 69 63 20 41 50      ## Public AP
0b90: 49 2e 20 28 49 6e 74 72 6f 73 70 65 63 74 69 6f  I. (Introspectio
0ba0: 6e 2c 20 6d 6f 73 74 6c 79 29 2e 0a 20 20 20 20  n, mostly)..    
0bb0: 23 23 20 2d 20 44 65 74 65 72 6d 69 6e 65 20 73  ## - Determine s
0bc0: 65 74 20 6f 66 20 6b 6e 6f 77 6e 20 61 63 74 69  et of known acti
0bd0: 6f 6e 73 2e 0a 20 20 20 20 23 23 20 2d 20 44 65  ons..    ## - De
0be0: 74 65 72 6d 69 6e 65 20 64 65 66 61 75 6c 74 20  termine default 
0bf0: 61 63 74 69 6f 6e 2e 0a 20 20 20 20 23 23 20 2d  action..    ## -
0c00: 20 44 65 74 65 72 6d 69 6e 65 20 68 61 6e 64 6c   Determine handl
0c10: 65 72 20 66 6f 72 20 61 6e 20 61 63 74 69 6f 6e  er for an action
0c20: 2e 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 6b 6e  ...    method kn
0c30: 6f 77 6e 20 7b 7d 20 7b 0a 09 64 65 62 75 67 2e  own {} {..debug.
0c40: 63 6d 64 72 2f 6f 66 66 69 63 65 72 20 7b 7d 0a  cmdr/officer {}.
0c50: 09 6d 79 20 53 65 74 75 70 0a 09 73 65 74 20 72  .my Setup..set r
0c60: 65 73 75 6c 74 20 7b 7d 0a 09 64 69 63 74 20 66  esult {}..dict f
0c70: 6f 72 20 7b 6b 20 76 7d 20 24 6d 79 6d 61 70 20  or {k v} $mymap 
0c80: 7b 0a 09 20 20 20 20 69 66 20 7b 21 5b 73 74 72  {..    if {![str
0c90: 69 6e 67 20 6d 61 74 63 68 20 61 2c 2a 20 24 6b  ing match a,* $k
0ca0: 5d 7d 20 63 6f 6e 74 69 6e 75 65 0a 09 20 20 20  ]} continue..   
0cb0: 20 6c 61 70 70 65 6e 64 20 72 65 73 75 6c 74 20   lappend result 
0cc0: 5b 73 74 72 69 6e 67 20 72 61 6e 67 65 20 24 6b  [string range $k
0cd0: 20 32 20 65 6e 64 5d 0a 09 7d 0a 09 72 65 74 75   2 end]..}..retu
0ce0: 72 6e 20 24 72 65 73 75 6c 74 0a 20 20 20 20 7d  rn $result.    }
0cf0: 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 68 61 73  ..    method has
0d00: 64 65 66 61 75 6c 74 20 7b 7d 20 7b 0a 09 64 65  default {} {..de
0d10: 62 75 67 2e 63 6d 64 72 2f 6f 66 66 69 63 65 72  bug.cmdr/officer
0d20: 20 7b 7d 20 31 30 0a 09 6d 79 20 53 65 74 75 70   {} 10..my Setup
0d30: 0a 09 72 65 74 75 72 6e 20 5b 64 69 63 74 20 65  ..return [dict e
0d40: 78 69 73 74 73 20 24 6d 79 6d 61 70 20 64 65 66  xists $mymap def
0d50: 61 75 6c 74 5d 0a 20 20 20 20 7d 0a 0a 20 20 20  ault].    }..   
0d60: 20 6d 65 74 68 6f 64 20 64 65 66 61 75 6c 74 20   method default 
0d70: 7b 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d 64 72  {} {..debug.cmdr
0d80: 2f 6f 66 66 69 63 65 72 20 7b 7d 20 31 30 0a 09  /officer {} 10..
0d90: 6d 79 20 53 65 74 75 70 0a 09 72 65 74 75 72 6e  my Setup..return
0da0: 20 5b 64 69 63 74 20 67 65 74 20 24 6d 79 6d 61   [dict get $myma
0db0: 70 20 64 65 66 61 75 6c 74 5d 0a 20 20 20 20 7d  p default].    }
0dc0: 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 6c 6f 6f  ..    method loo
0dd0: 6b 75 70 20 7b 6e 61 6d 65 7d 20 7b 0a 09 64 65  kup {name} {..de
0de0: 62 75 67 2e 63 6d 64 72 2f 6f 66 66 69 63 65 72  bug.cmdr/officer
0df0: 20 7b 7d 0a 09 6d 79 20 53 65 74 75 70 0a 09 69   {}..my Setup..i
0e00: 66 20 7b 21 5b 64 69 63 74 20 65 78 69 73 74 73  f {![dict exists
0e10: 20 24 6d 79 6d 61 70 20 61 2c 24 6e 61 6d 65 5d   $mymap a,$name]
0e20: 7d 20 7b 0a 09 20 20 20 20 72 65 74 75 72 6e 20  } {..    return 
0e30: 2d 63 6f 64 65 20 65 72 72 6f 72 20 5c 0a 09 09  -code error \...
0e40: 2d 65 72 72 6f 72 63 6f 64 65 20 5b 6c 69 73 74  -errorcode [list
0e50: 20 43 4d 44 52 20 41 43 54 49 4f 4e 20 55 4e 4b   CMDR ACTION UNK
0e60: 4e 4f 57 4e 20 24 6e 61 6d 65 5d 20 5c 0a 09 09  NOWN $name] \...
0e70: 22 45 78 70 65 63 74 65 64 20 61 63 74 69 6f 6e  "Expected action
0e80: 20 6e 61 6d 65 2c 20 67 6f 74 20 5c 22 24 6e 61   name, got \"$na
0e90: 6d 65 5c 22 22 0a 09 7d 0a 09 72 65 74 75 72 6e  me\""..}..return
0ea0: 20 5b 64 69 63 74 20 67 65 74 20 24 6d 79 6d 61   [dict get $myma
0eb0: 70 20 61 2c 24 6e 61 6d 65 5d 0a 20 20 20 20 7d  p a,$name].    }
0ec0: 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 68 61 73  ..    method has
0ed0: 20 7b 6e 61 6d 65 7d 20 7b 0a 09 64 65 62 75 67   {name} {..debug
0ee0: 2e 63 6d 64 72 2f 6f 66 66 69 63 65 72 20 7b 7d  .cmdr/officer {}
0ef0: 0a 09 6d 79 20 53 65 74 75 70 0a 09 72 65 74 75  ..my Setup..retu
0f00: 72 6e 20 5b 64 69 63 74 20 65 78 69 73 74 73 20  rn [dict exists 
0f10: 24 6d 79 6d 61 70 20 61 2c 24 6e 61 6d 65 5d 0a  $mymap a,$name].
0f20: 20 20 20 20 7d 0a 0a 20 20 20 20 6d 65 74 68 6f      }..    metho
0f30: 64 20 63 68 69 6c 64 72 65 6e 20 7b 7d 20 7b 0a  d children {} {.
0f40: 09 64 65 62 75 67 2e 63 6d 64 72 2f 6f 66 66 69  .debug.cmdr/offi
0f50: 63 65 72 20 7b 7d 0a 09 6d 79 20 53 65 74 75 70  cer {}..my Setup
0f60: 0a 09 72 65 74 75 72 6e 20 24 6d 79 63 68 69 6c  ..return $mychil
0f70: 64 72 65 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20  dren.    }..    
0f80: 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23  # # ## ### #####
0f90: 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23   ######## ######
0fa0: 23 23 23 23 23 23 23 0a 20 20 20 20 23 23 20 49  #######.    ## I
0fb0: 6e 74 65 72 6e 61 6c 2e 20 44 69 73 70 61 74 63  nternal. Dispatc
0fc0: 68 65 72 20 73 65 74 75 70 2e 20 44 65 66 65 72  her setup. Defer
0fd0: 65 64 20 75 6e 74 69 6c 20 72 65 71 75 69 72 65  ed until require
0fe0: 64 2e 0a 20 20 20 20 23 23 20 43 6f 72 65 20 73  d..    ## Core s
0ff0: 65 74 75 70 20 63 6f 64 65 20 72 75 6e 73 20 6f  etup code runs o
1000: 6e 6c 79 20 6f 6e 63 65 2e 0a 0a 20 20 20 20 6d  nly once...    m
1010: 65 74 68 6f 64 20 53 65 74 75 70 20 7b 7d 20 7b  ethod Setup {} {
1020: 0a 09 23 20 50 72 6f 63 65 73 73 20 74 68 65 20  ..# Process the 
1030: 61 63 74 69 6f 6e 20 73 70 65 63 69 66 69 63 61  action specifica
1040: 74 69 6f 6e 20 6f 6e 6c 79 20 6f 6e 63 65 2e 0a  tion only once..
1050: 09 69 66 20 7b 24 6d 79 69 6e 69 74 7d 20 72 65  .if {$myinit} re
1060: 74 75 72 6e 0a 09 73 65 74 20 6d 79 69 6e 69 74  turn..set myinit
1070: 20 31 0a 09 64 65 62 75 67 2e 63 6d 64 72 2f 6f   1..debug.cmdr/o
1080: 66 66 69 63 65 72 20 7b 7d 0a 0a 09 6d 79 20 6c  fficer {}...my l
1090: 65 61 72 6e 20 24 6d 79 61 63 74 69 6f 6e 73 0a  earn $myactions.
10a0: 0a 09 23 20 41 75 74 6f 2d 63 72 65 61 74 65 20  ..# Auto-create 
10b0: 61 20 27 68 65 6c 70 27 20 63 6f 6d 6d 61 6e 64  a 'help' command
10c0: 20 77 68 65 6e 20 70 6f 73 73 69 62 6c 65 2c 20   when possible, 
10d0: 69 2e 65 20 6e 6f 74 20 69 6e 0a 09 23 20 63 6f  i.e not in..# co
10e0: 6e 66 6c 69 63 74 20 77 69 74 68 20 61 20 75 73  nflict with a us
10f0: 65 72 2d 73 70 65 63 69 66 69 65 64 20 63 6f 6d  er-specified com
1100: 6d 61 6e 64 2e 0a 09 69 66 20 7b 21 5b 6d 79 20  mand...if {![my 
1110: 68 61 73 20 68 65 6c 70 5d 7d 20 7b 0a 09 20 20  has help]} {..  
1120: 20 20 63 6d 64 72 20 68 65 6c 70 20 61 75 74 6f    cmdr help auto
1130: 20 5b 73 65 6c 66 5d 0a 09 7d 0a 0a 09 23 20 41   [self]..}...# A
1140: 75 74 6f 2d 63 72 65 61 74 65 20 61 6e 20 27 65  uto-create an 'e
1150: 78 69 74 27 20 63 6f 6d 6d 61 6e 64 20 77 68 65  xit' command whe
1160: 6e 20 70 6f 73 73 69 62 6c 65 2c 20 69 2e 65 20  n possible, i.e 
1170: 6e 6f 74 20 69 6e 0a 09 23 20 63 6f 6e 66 6c 69  not in..# confli
1180: 63 74 20 77 69 74 68 20 61 20 75 73 65 72 2d 73  ct with a user-s
1190: 70 65 63 69 66 69 65 64 20 63 6f 6d 6d 61 6e 64  pecified command
11a0: 2e 0a 09 69 66 20 7b 21 5b 6d 79 20 68 61 73 20  ...if {![my has 
11b0: 65 78 69 74 5d 7d 20 7b 0a 09 20 20 20 20 6d 79  exit]} {..    my
11c0: 20 6c 65 61 72 6e 20 7b 0a 09 09 70 72 69 76 61   learn {...priva
11d0: 74 65 20 65 78 69 74 20 7b 0a 09 09 20 20 20 20  te exit {...    
11e0: 64 65 73 63 72 69 70 74 69 6f 6e 20 7b 0a 09 09  description {...
11f0: 09 45 78 69 74 20 74 68 65 20 73 68 65 6c 6c 2e  .Exit the shell.
1200: 0a 09 09 09 4e 6f 2d 6f 70 20 69 66 20 6e 6f 74  ....No-op if not
1210: 20 69 6e 20 61 20 73 68 65 6c 6c 2e 0a 09 09 20   in a shell.... 
1220: 20 20 20 7d 0a 09 09 7d 20 5b 6d 79 6d 65 74 68     }...} [mymeth
1230: 6f 64 20 73 68 65 6c 6c 2d 65 78 69 74 5d 0a 09  od shell-exit]..
1240: 20 20 20 20 7d 0a 09 7d 0a 09 72 65 74 75 72 6e      }..}..return
1250: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6d 65 74 68  .    }..    meth
1260: 6f 64 20 6c 65 61 72 6e 20 7b 73 63 72 69 70 74  od learn {script
1270: 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d 64 72 2f  } {..debug.cmdr/
1280: 6f 66 66 69 63 65 72 20 7b 7d 0a 09 23 20 4d 61  officer {}..# Ma
1290: 6b 65 20 74 68 65 20 44 53 4c 20 63 6f 6d 6d 61  ke the DSL comma
12a0: 6e 64 73 20 64 69 72 65 63 74 6c 79 20 61 76 61  nds directly ava
12b0: 69 6c 61 62 6c 65 2e 20 4e 6f 74 65 20 74 68 61  ilable. Note tha
12c0: 74 0a 09 23 20 22 64 65 73 63 72 69 70 74 69 6f  t..# "descriptio
12d0: 6e 3a 22 20 61 6e 64 20 22 63 6f 6d 6d 6f 6e 22  n:" and "common"
12e0: 20 61 72 65 20 73 75 70 65 72 63 6c 61 73 73 20   are superclass 
12f0: 6d 65 74 68 6f 64 73 2c 20 61 6e 64 0a 09 23 20  methods, and..# 
1300: 72 65 6e 61 6d 65 64 20 74 6f 20 74 68 65 69 72  renamed to their
1310: 20 44 53 4c 20 63 6f 75 6e 74 65 72 70 61 72 74   DSL counterpart
1320: 73 2e 20 54 68 65 20 6f 74 68 65 72 73 20 61 72  s. The others ar
1330: 65 20 75 6e 65 78 70 6f 72 74 65 64 0a 09 23 20  e unexported..# 
1340: 69 6e 73 74 61 6e 63 65 20 6d 65 74 68 6f 64 73  instance methods
1350: 20 6f 66 20 74 68 69 73 20 63 6c 61 73 73 2e 0a   of this class..
1360: 0a 09 6c 69 6e 6b 20 5c 0a 09 20 20 20 20 7b 65  ..link \..    {e
1370: 68 61 6e 64 6c 65 72 20 20 20 20 65 68 61 6e 64  handler    ehand
1380: 6c 65 72 7d 20 5c 0a 09 20 20 20 20 7b 70 72 69  ler} \..    {pri
1390: 76 61 74 65 20 20 20 20 20 50 72 69 76 61 74 65  vate     Private
13a0: 7d 20 5c 0a 09 20 20 20 20 7b 6f 66 66 69 63 65  } \..    {office
13b0: 72 20 20 20 20 20 4f 66 66 69 63 65 72 7d 20 5c  r     Officer} \
13c0: 0a 09 20 20 20 20 7b 64 65 66 61 75 6c 74 20 20  ..    {default  
13d0: 20 20 20 44 65 66 61 75 6c 74 7d 20 5c 0a 09 20     Default} \.. 
13e0: 20 20 20 7b 61 6c 69 61 73 20 20 20 20 20 20 20     {alias       
13f0: 41 6c 69 61 73 7d 20 5c 0a 09 20 20 20 20 7b 64  Alias} \..    {d
1400: 65 73 63 72 69 70 74 69 6f 6e 20 64 65 73 63 72  escription descr
1410: 69 70 74 69 6f 6e 3a 7d 20 5c 0a 09 20 20 20 20  iption:} \..    
1420: 75 6e 64 6f 63 75 6d 65 6e 74 65 64 20 5c 0a 09  undocumented \..
1430: 20 20 20 20 7b 63 6f 6d 6d 6f 6e 20 20 20 20 20      {common     
1440: 20 73 65 74 7d 0a 09 65 76 61 6c 20 24 73 63 72   set}..eval $scr
1450: 69 70 74 0a 0a 09 23 20 50 6f 73 74 70 72 6f 63  ipt...# Postproc
1460: 65 73 73 69 6e 67 2e 0a 09 73 65 74 20 6d 79 63  essing...set myc
1470: 6f 6d 6d 61 6e 64 73 20 5b 6c 73 6f 72 74 20 2d  ommands [lsort -
1480: 64 69 63 74 20 24 6d 79 63 6f 6d 6d 61 6e 64 73  dict $mycommands
1490: 5d 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a  ]..return.    }.
14a0: 0a 20 20 20 20 23 20 43 6f 6e 76 65 6e 69 65 6e  .    # Convenien
14b0: 63 65 20 6d 65 74 68 6f 64 20 66 6f 72 20 64 79  ce method for dy
14c0: 6e 61 6d 69 63 61 6c 6c 79 20 63 72 65 61 74 69  namically creati
14d0: 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 20 68 69 65  ng a command hie
14e0: 72 61 72 63 68 79 2e 0a 20 20 20 20 23 20 43 6f  rarchy..    # Co
14f0: 6d 6d 61 6e 64 20 73 70 65 63 69 66 69 65 64 20  mmand specified 
1500: 61 73 20 70 61 74 68 2c 20 69 6e 74 65 72 6d 65  as path, interme
1510: 64 69 61 74 65 20 6f 66 66 69 63 65 72 73 20 61  diate officers a
1520: 72 65 20 67 65 6e 65 72 61 74 65 64 0a 20 20 20  re generated.   
1530: 20 23 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79   # automatically
1540: 20 61 73 20 6e 65 65 64 65 64 2e 0a 0a 20 20 20   as needed...   
1550: 20 6d 65 74 68 6f 64 20 65 78 74 65 6e 64 20 7b   method extend {
1560: 70 61 74 68 20 61 72 67 75 6d 65 6e 74 73 20 61  path arguments a
1570: 63 74 69 6f 6e 7d 20 7b 0a 09 69 66 20 7b 5b 6c  ction} {..if {[l
1580: 6c 65 6e 67 74 68 20 24 70 61 74 68 5d 20 3d 3d  length $path] ==
1590: 20 31 7d 20 7b 0a 09 20 20 20 20 23 20 52 65 61   1} {..    # Rea
15a0: 63 68 65 64 20 74 68 65 20 62 6f 74 74 6f 6d 20  ched the bottom 
15b0: 6f 66 20 74 68 65 20 72 65 63 75 72 73 69 6f 6e  of the recursion
15c0: 2e 0a 09 20 20 20 20 23 20 47 65 6e 65 72 61 74  ...    # Generat
15d0: 65 20 74 68 65 20 70 72 69 76 61 74 65 20 68 61  e the private ha
15e0: 6e 64 6c 69 6e 67 20 61 72 67 75 6d 65 6e 74 73  ndling arguments
15f0: 20 61 6e 64 20 61 63 74 69 6f 6e 2e 0a 09 20 20   and action...  
1600: 20 20 73 65 74 20 63 6d 64 20 5b 6c 69 6e 64 65    set cmd [linde
1610: 78 20 24 70 61 74 68 20 30 5d 0a 09 20 20 20 20  x $path 0]..    
1620: 72 65 74 75 72 6e 20 5b 6d 79 20 50 72 69 76 61  return [my Priva
1630: 74 65 20 24 63 6d 64 20 24 61 72 67 75 6d 65 6e  te $cmd $argumen
1640: 74 73 20 24 61 63 74 69 6f 6e 5d 0a 09 7d 0a 0a  ts $action]..}..
1650: 09 23 20 52 65 63 75 72 73 65 2c 20 63 72 65 61  .# Recurse, crea
1660: 74 69 6e 67 20 74 68 65 20 69 6e 74 65 72 6d 65  ting the interme
1670: 64 69 61 74 65 20 6f 66 66 69 63 65 72 73 20 61  diate officers a
1680: 73 20 6e 65 65 64 65 64 2e 0a 09 73 65 74 20 70  s needed...set p
1690: 61 74 68 20 5b 6c 61 73 73 69 67 6e 20 24 70 61  ath [lassign $pa
16a0: 74 68 20 63 6d 64 5d 0a 09 69 66 20 7b 21 5b 6d  th cmd]..if {![m
16b0: 79 20 68 61 73 20 24 63 6d 64 5d 7d 20 7b 0a 09  y has $cmd]} {..
16c0: 20 20 20 20 6d 79 20 4f 66 66 69 63 65 72 20 24      my Officer $
16d0: 63 6d 64 20 7b 7d 0a 09 7d 0a 0a 09 5b 6d 79 20  cmd {}..}...[my 
16e0: 6c 6f 6f 6b 75 70 20 24 63 6d 64 5d 20 65 78 74  lookup $cmd] ext
16f0: 65 6e 64 20 24 70 61 74 68 20 24 61 72 67 75 6d  end $path $argum
1700: 65 6e 74 73 20 24 61 63 74 69 6f 6e 0a 20 20 20  ents $action.   
1710: 20 7d 0a 0a 20 20 20 20 23 20 23 20 23 23 20 23   }..    # # ## #
1720: 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23 23  ## ##### #######
1730: 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  # #############.
1740: 20 20 20 20 23 23 20 49 6d 70 6c 65 6d 65 6e 74      ## Implement
1750: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 61 63 74  ation of the act
1760: 69 6f 6e 20 73 70 65 63 69 66 69 63 61 74 69 6f  ion specificatio
1770: 6e 20 6c 61 6e 67 75 61 67 65 2e 0a 0a 20 20 20  n language...   
1780: 20 23 20 63 6f 6d 6d 6f 6e 20 20 20 20 20 20 3d   # common      =
1790: 3e 20 73 65 74 20 20 20 20 20 20 20 20 20 20 28  > set          (
17a0: 73 75 70 65 72 20 63 6d 64 72 3a 3a 61 63 74 6f  super cmdr::acto
17b0: 72 29 0a 20 20 20 20 23 20 64 65 73 63 72 69 70  r).    # descrip
17c0: 74 69 6f 6e 20 3d 3e 20 64 65 73 63 72 69 70 74  tion => descript
17d0: 69 6f 6e 3a 20 28 73 75 70 65 72 20 63 6d 64 72  ion: (super cmdr
17e0: 3a 3a 61 63 74 6f 72 29 0a 0a 20 20 20 20 66 6f  ::actor)..    fo
17f0: 72 77 61 72 64 20 50 72 69 76 61 74 65 20 6d 79  rward Private my
1800: 20 44 65 66 69 6e 65 41 63 74 69 6f 6e 20 70 72   DefineAction pr
1810: 69 76 61 74 65 0a 20 20 20 20 66 6f 72 77 61 72  ivate.    forwar
1820: 64 20 4f 66 66 69 63 65 72 20 6d 79 20 44 65 66  d Officer my Def
1830: 69 6e 65 41 63 74 69 6f 6e 20 6f 66 66 69 63 65  ineAction office
1840: 72 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 44 65  r..    method De
1850: 66 61 75 6c 74 20 7b 7b 6e 61 6d 65 20 7b 7d 7d  fault {{name {}}
1860: 7d 20 7b 0a 09 69 66 20 7b 5b 6c 6c 65 6e 67 74  } {..if {[llengt
1870: 68 20 5b 69 6e 66 6f 20 6c 65 76 65 6c 20 30 5d  h [info level 0]
1880: 5d 20 3d 3d 20 32 7d 20 7b 0a 09 20 20 20 20 73  ] == 2} {..    s
1890: 65 74 20 6e 61 6d 65 20 5b 6d 79 20 4c 61 73 74  et name [my Last
18a0: 5d 0a 09 7d 20 65 6c 73 65 69 66 20 7b 21 5b 64  ]..} elseif {![d
18b0: 69 63 74 20 65 78 69 73 74 73 20 24 6d 79 6d 61  ict exists $myma
18c0: 70 20 61 2c 24 6e 61 6d 65 5d 7d 20 7b 0a 09 20  p a,$name]} {.. 
18d0: 20 20 20 72 65 74 75 72 6e 20 2d 63 6f 64 65 20     return -code 
18e0: 65 72 72 6f 72 20 5c 0a 09 09 2d 65 72 72 6f 72  error \...-error
18f0: 63 6f 64 65 20 5b 6c 69 73 74 20 43 4d 44 52 20  code [list CMDR 
1900: 41 43 54 49 4f 4e 20 55 4e 4b 4e 4f 57 4e 20 24  ACTION UNKNOWN $
1910: 6e 61 6d 65 5d 20 5c 0a 09 09 22 55 6e 61 62 6c  name] \..."Unabl
1920: 65 20 74 6f 20 73 65 74 20 64 65 66 61 75 6c 74  e to set default
1930: 2c 20 65 78 70 65 63 74 65 64 20 61 63 74 69 6f  , expected actio
1940: 6e 2c 20 67 6f 74 20 5c 22 24 6e 61 6d 65 5c 22  n, got \"$name\"
1950: 22 0a 09 7d 0a 09 64 69 63 74 20 73 65 74 20 6d  "..}..dict set m
1960: 79 6d 61 70 20 64 65 66 61 75 6c 74 20 24 6e 61  ymap default $na
1970: 6d 65 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d  me..return.    }
1980: 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 41 6c 69  ..    method Ali
1990: 61 73 20 7b 6e 61 6d 65 20 61 72 67 73 7d 20 7b  as {name args} {
19a0: 0a 09 73 65 74 20 6e 20 5b 6c 6c 65 6e 67 74 68  ..set n [llength
19b0: 20 24 61 72 67 73 5d 0a 09 69 66 20 7b 28 24 6e   $args]..if {($n
19c0: 20 3d 3d 20 31 29 20 7c 7c 20 28 28 24 6e 20 3e   == 1) || (($n >
19d0: 20 31 29 20 26 26 20 28 5b 6c 69 6e 64 65 78 20   1) && ([lindex 
19e0: 24 61 72 67 73 20 30 5d 20 6e 65 20 22 3d 22 29  $args 0] ne "=")
19f0: 29 7d 20 7b 0a 09 20 20 20 20 72 65 74 75 72 6e  )} {..    return
1a00: 20 2d 63 6f 64 65 20 65 72 72 6f 72 20 5c 0a 09   -code error \..
1a10: 09 22 77 72 6f 6e 67 5c 23 61 72 67 73 3a 20 73  ."wrong\#args: s
1a20: 68 6f 75 6c 64 20 62 65 20 5c 22 6e 61 6d 65 20  hould be \"name 
1a30: 3f 3d 20 63 6d 64 20 3f 77 6f 72 64 2e 2e 2e 3f  ?= cmd ?word...?
1a40: 3f 5c 22 22 0a 09 7d 0a 09 6d 79 20 56 61 6c 69  ?\""..}..my Vali
1a50: 64 61 74 65 41 73 55 6e 6b 6e 6f 77 6e 20 24 6e  dateAsUnknown $n
1a60: 61 6d 65 0a 0a 09 69 66 20 7b 24 6e 20 3d 3d 20  ame...if {$n == 
1a70: 30 7d 20 7b 0a 09 20 20 20 20 23 20 53 69 6d 70  0} {..    # Simp
1a80: 6c 65 20 61 6c 69 61 73 2c 20 74 6f 20 70 72 65  le alias, to pre
1a90: 63 65 64 69 6e 67 20 61 63 74 69 6f 6e 2e 0a 09  ceding action...
1aa0: 20 20 20 20 73 65 74 20 68 61 6e 64 6c 65 72 20      set handler 
1ab0: 5b 6d 79 20 6c 6f 6f 6b 75 70 20 5b 6d 79 20 4c  [my lookup [my L
1ac0: 61 73 74 5d 5d 0a 09 7d 20 65 6c 73 65 20 7b 0a  ast]]..} else {.
1ad0: 09 20 20 20 20 23 20 54 72 61 63 6b 20 74 68 65  .    # Track the
1ae0: 20 63 68 61 69 6e 20 6f 66 20 77 6f 72 64 73 20   chain of words 
1af0: 74 68 72 6f 75 67 68 20 74 68 65 20 65 78 69 73  through the exis
1b00: 74 69 6e 67 20 68 69 65 72 61 72 63 68 79 0a 09  ting hierarchy..
1b10: 20 20 20 20 23 20 6f 66 20 61 63 74 69 6f 6e 73      # of actions
1b20: 20 74 6f 20 6c 6f 63 61 74 65 20 74 68 65 20 66   to locate the f
1b30: 69 6e 61 6c 20 68 61 6e 64 6c 65 72 2e 0a 09 20  inal handler... 
1b40: 20 20 20 73 65 74 20 68 61 6e 64 6c 65 72 20 5b     set handler [
1b50: 73 65 6c 66 5d 0a 09 20 20 20 20 66 6f 72 65 61  self]..    forea
1b60: 63 68 20 77 6f 72 64 20 5b 6c 61 73 73 69 67 6e  ch word [lassign
1b70: 20 24 61 72 67 73 20 5f 64 75 6d 6d 79 5f 5d 20   $args _dummy_] 
1b80: 7b 0a 09 09 73 65 74 20 68 61 6e 64 6c 65 72 20  {...set handler 
1b90: 5b 24 68 61 6e 64 6c 65 72 20 6c 6f 6f 6b 75 70  [$handler lookup
1ba0: 20 24 77 6f 72 64 5d 0a 09 20 20 20 20 7d 0a 09   $word]..    }..
1bb0: 7d 0a 0a 09 23 20 57 65 20 65 73 73 65 6e 74 69  }...# We essenti
1bc0: 61 6c 6c 79 20 63 6f 70 79 20 74 68 65 20 64 65  ally copy the de
1bd0: 66 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 65 20  finition of the 
1be0: 63 6f 6d 6d 61 6e 64 20 74 68 65 20 61 6c 69 61  command the alia
1bf0: 73 0a 09 23 20 72 65 66 65 72 73 20 74 6f 2e 0a  s..# refers to..
1c00: 09 6d 79 20 44 65 66 20 24 6e 61 6d 65 20 24 68  .my Def $name $h
1c10: 61 6e 64 6c 65 72 0a 09 72 65 74 75 72 6e 0a 20  andler..return. 
1c20: 20 20 20 7d 0a 0a 20 20 20 20 23 20 49 6e 74 65     }..    # Inte
1c30: 72 6e 61 6c 2e 20 43 6f 6d 6d 6f 6e 20 63 6f 64  rnal. Common cod
1c40: 65 20 74 6f 20 64 65 63 6c 61 72 65 20 61 63 74  e to declare act
1c50: 69 6f 6e 73 20 61 6e 64 20 74 68 65 69 72 20 68  ions and their h
1c60: 61 6e 64 6c 65 72 73 2e 0a 20 20 20 20 6d 65 74  andlers..    met
1c70: 68 6f 64 20 44 65 66 69 6e 65 41 63 74 69 6f 6e  hod DefineAction
1c80: 20 7b 77 68 61 74 20 6e 61 6d 65 20 61 72 67 73   {what name args
1c90: 7d 20 7b 0a 09 6d 79 20 56 61 6c 69 64 61 74 65  } {..my Validate
1ca0: 41 73 55 6e 6b 6e 6f 77 6e 20 24 6e 61 6d 65 0a  AsUnknown $name.
1cb0: 0a 09 23 20 4e 6f 74 65 3a 20 42 79 20 70 6c 61  ..# Note: By pla
1cc0: 63 69 6e 67 20 74 68 65 20 73 75 62 6f 72 64 69  cing the subordi
1cd0: 6e 61 74 65 20 6f 62 6a 65 63 74 73 20 69 6e 74  nate objects int
1ce0: 6f 20 74 68 65 20 6f 66 66 69 63 65 72 27 73 0a  o the officer's.
1cf0: 09 23 20 6e 61 6d 65 73 70 61 63 65 20 74 68 65  .# namespace the
1d00: 79 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61  y will be automa
1d10: 74 69 63 61 6c 6c 79 20 64 65 73 74 72 6f 79 65  tically destroye
1d20: 64 20 77 69 74 68 20 74 68 65 0a 09 23 20 6f 66  d with the..# of
1d30: 66 69 63 65 72 20 69 74 73 65 6c 66 2e 20 4e 6f  ficer itself. No
1d40: 20 73 70 65 63 69 61 6c 20 63 6f 64 65 20 66 6f   special code fo
1d50: 72 20 63 6c 65 61 6e 75 70 20 72 65 71 75 69 72  r cleanup requir
1d60: 65 64 2e 0a 0a 09 73 65 74 20 68 61 6e 64 6c 65  ed....set handle
1d70: 72 20 5b 73 65 6c 66 20 6e 61 6d 65 73 70 61 63  r [self namespac
1d80: 65 5d 3a 3a 24 7b 77 68 61 74 7d 5f 24 6e 61 6d  e]::${what}_$nam
1d90: 65 0a 09 63 6d 64 72 3a 3a 24 77 68 61 74 20 63  e..cmdr::$what c
1da0: 72 65 61 74 65 20 24 68 61 6e 64 6c 65 72 20 5b  reate $handler [
1db0: 73 65 6c 66 5d 20 24 6e 61 6d 65 20 7b 2a 7d 24  self] $name {*}$
1dc0: 61 72 67 73 0a 0a 09 23 20 50 72 6f 70 61 67 61  args...# Propaga
1dd0: 74 65 20 65 72 72 6f 72 20 68 61 6e 64 6c 65 72  te error handler
1de0: 2e 0a 09 24 68 61 6e 64 6c 65 72 20 65 68 61 6e  ...$handler ehan
1df0: 64 6c 65 72 20 24 6d 79 68 61 6e 64 6c 65 72 0a  dler $myhandler.
1e00: 0a 09 6c 61 70 70 65 6e 64 20 6d 79 63 68 69 6c  ..lappend mychil
1e10: 64 72 65 6e 20 24 68 61 6e 64 6c 65 72 0a 0a 09  dren $handler...
1e20: 6d 79 20 44 65 66 20 24 6e 61 6d 65 20 24 68 61  my Def $name $ha
1e30: 6e 64 6c 65 72 0a 09 72 65 74 75 72 6e 20 24 68  ndler..return $h
1e40: 61 6e 64 6c 65 72 0a 20 20 20 20 7d 0a 0a 20 20  andler.    }..  
1e50: 20 20 6d 65 74 68 6f 64 20 44 65 66 20 7b 6e 61    method Def {na
1e60: 6d 65 20 68 61 6e 64 6c 65 72 7d 20 7b 0a 09 23  me handler} {..#
1e70: 20 4d 61 6b 65 20 61 6e 20 61 63 74 69 6f 6e 20   Make an action 
1e80: 6b 6e 6f 77 6e 20 74 6f 20 74 68 65 20 64 69 73  known to the dis
1e90: 70 61 74 63 68 65 72 2e 0a 09 64 69 63 74 20 73  patcher...dict s
1ea0: 65 74 20 6d 79 6d 61 70 20 6c 61 73 74 20 24 6e  et mymap last $n
1eb0: 61 6d 65 0a 09 64 69 63 74 20 73 65 74 20 6d 79  ame..dict set my
1ec0: 6d 61 70 20 20 20 61 2c 24 6e 61 6d 65 20 24 68  map   a,$name $h
1ed0: 61 6e 64 6c 65 72 0a 09 6c 61 70 70 65 6e 64 20  andler..lappend 
1ee0: 6d 79 63 6f 6d 6d 61 6e 64 73 20 24 6e 61 6d 65  mycommands $name
1ef0: 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a  ..return.    }..
1f00: 20 20 20 20 6d 65 74 68 6f 64 20 56 61 6c 69 64      method Valid
1f10: 61 74 65 41 73 55 6e 6b 6e 6f 77 6e 20 7b 6e 61  ateAsUnknown {na
1f20: 6d 65 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d 64  me} {..debug.cmd
1f30: 72 2f 6f 66 66 69 63 65 72 20 7b 7d 0a 09 69 66  r/officer {}..if
1f40: 20 7b 21 5b 64 69 63 74 20 65 78 69 73 74 73 20   {![dict exists 
1f50: 24 6d 79 6d 61 70 20 61 2c 24 6e 61 6d 65 5d 7d  $mymap a,$name]}
1f60: 20 72 65 74 75 72 6e 0a 09 72 65 74 75 72 6e 20   return..return 
1f70: 2d 63 6f 64 65 20 65 72 72 6f 72 20 2d 65 72 72  -code error -err
1f80: 6f 72 63 6f 64 65 20 7b 43 4d 44 52 20 41 43 54  orcode {CMDR ACT
1f90: 49 4f 4e 20 4b 4e 4f 57 4e 7d 20 5c 0a 09 20 20  ION KNOWN} \..  
1fa0: 20 20 22 55 6e 61 62 6c 65 20 74 6f 20 6c 65 61    "Unable to lea
1fb0: 72 6e 20 24 6e 61 6d 65 2c 20 61 6c 72 65 61 64  rn $name, alread
1fc0: 79 20 73 70 65 63 69 66 69 65 64 2e 22 0a 20 20  y specified.".  
1fd0: 20 20 7d 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20    }..    method 
1fe0: 4c 61 73 74 20 7b 7d 20 7b 0a 09 69 66 20 7b 21  Last {} {..if {!
1ff0: 5b 64 69 63 74 20 65 78 69 73 74 73 20 24 6d 79  [dict exists $my
2000: 6d 61 70 20 6c 61 73 74 5d 7d 20 7b 0a 09 20 20  map last]} {..  
2010: 20 20 72 65 74 75 72 6e 20 2d 63 6f 64 65 20 65    return -code e
2020: 72 72 6f 72 20 2d 65 72 72 6f 72 63 6f 64 65 20  rror -errorcode 
2030: 7b 43 4d 44 52 20 41 43 54 49 4f 4e 20 4e 4f 2d  {CMDR ACTION NO-
2040: 4c 41 53 54 7d 20 5c 0a 09 09 22 43 61 6e 6e 6f  LAST} \..."Canno
2050: 74 20 62 65 20 75 73 65 64 20 61 73 20 66 69 72  t be used as fir
2060: 73 74 20 63 6f 6d 6d 61 6e 64 22 0a 09 7d 0a 09  st command"..}..
2070: 72 65 74 75 72 6e 20 5b 64 69 63 74 20 67 65 74  return [dict get
2080: 20 24 6d 79 6d 61 70 20 6c 61 73 74 5d 0a 20 20   $mymap last].  
2090: 20 20 7d 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20    }..    method 
20a0: 4b 6e 6f 77 6e 20 7b 6e 61 6d 65 7d 20 7b 0a 09  Known {name} {..
20b0: 72 65 74 75 72 6e 20 5b 64 69 63 74 20 65 78 69  return [dict exi
20c0: 73 74 73 20 24 6d 79 6d 61 70 20 61 2c 24 6e 61  sts $mymap a,$na
20d0: 6d 65 5d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23  me].    }..    #
20e0: 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20   # ## ### ##### 
20f0: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
2100: 23 23 23 23 23 23 0a 20 20 20 20 23 23 20 43 6f  ######.    ## Co
2110: 6d 6d 61 6e 64 20 64 69 73 70 61 74 63 68 65 72  mmand dispatcher
2120: 2e 20 43 68 6f 6f 73 65 20 74 68 65 20 73 75 62  . Choose the sub
2130: 6f 72 64 69 6e 61 74 65 20 61 6e 64 20 64 65 6c  ordinate and del
2140: 65 67 61 74 65 2e 0a 0a 20 20 20 20 6d 65 74 68  egate...    meth
2150: 6f 64 20 64 6f 20 7b 61 72 67 73 7d 20 7b 0a 09  od do {args} {..
2160: 64 65 62 75 67 2e 63 6d 64 72 2f 6f 66 66 69 63  debug.cmdr/offic
2170: 65 72 20 7b 7d 0a 09 6d 79 20 53 65 74 75 70 0a  er {}..my Setup.
2180: 0a 09 23 20 4e 6f 20 63 6f 6d 6d 61 6e 64 20 73  ..# No command s
2190: 70 65 63 69 66 69 65 64 2c 20 77 68 61 74 20 73  pecified, what s
21a0: 68 6f 75 6c 64 20 77 65 20 64 6f 20 3f 0a 09 23  hould we do ?..#
21b0: 20 28 31 29 20 49 66 20 74 68 65 72 65 20 69 73   (1) If there is
21c0: 20 61 20 64 65 66 61 75 6c 74 2c 20 77 65 20 63   a default, we c
21d0: 61 6e 20 67 6f 20 6f 6e 20 28 44 6f 20 77 69 6c  an go on (Do wil
21e0: 6c 20 63 61 6c 6c 20 6f 6e 20 69 74 29 2e 0a 09  l call on it)...
21f0: 23 20 28 32 29 20 57 69 74 68 6f 75 74 20 64 65  # (2) Without de
2200: 66 61 75 6c 74 20 77 65 20 6d 75 73 74 20 65 6e  fault we must en
2210: 74 65 72 20 61 6e 20 69 6e 74 65 72 61 63 74 69  ter an interacti
2220: 76 65 20 73 68 65 6c 6c 2e 0a 09 23 20 28 33 29  ve shell...# (3)
2230: 20 45 78 63 65 70 74 20 69 66 20 69 6e 74 65 72   Except if inter
2240: 61 63 74 69 6f 6e 20 69 73 20 67 6c 6f 62 61 6c  action is global
2250: 6c 79 20 73 75 70 70 72 65 73 73 65 64 2e 20 54  ly suppressed. T
2260: 68 65 6e 20 77 65 0a 09 23 20 20 20 20 20 66 61  hen we..#     fa
2270: 6c 6c 20 74 68 72 6f 75 67 68 2c 20 61 67 61 69  ll through, agai
2280: 6e 2c 20 74 6f 20 67 65 6e 65 72 61 74 65 20 74  n, to generate t
2290: 68 65 20 70 72 6f 70 65 72 20 65 72 72 6f 72 20  he proper error 
22a0: 6d 65 73 73 61 67 65 2e 0a 09 23 0a 09 23 20 52  message...#..# R
22b0: 65 73 75 6c 74 3a 20 49 6e 74 65 72 61 63 74 20  esult: Interact 
22c0: 77 69 74 68 20 74 68 65 20 75 73 65 72 20 69 66  with the user if
22d0: 20 6e 6f 20 63 6f 6d 6d 61 6e 64 20 77 61 73 20   no command was 
22e0: 73 70 65 63 69 66 69 65 64 2c 0a 09 23 20 77 65  specified,..# we
22f0: 20 68 61 76 65 20 6e 6f 20 64 65 66 61 75 6c 74   have no default
2300: 20 74 6f 20 70 75 6e 74 20 74 6f 20 61 6e 64 20   to punt to and 
2310: 69 6e 74 65 72 61 63 74 69 6f 6e 20 69 73 20 67  interaction is g
2320: 6c 6f 62 61 6c 6c 79 0a 09 23 20 61 6c 6c 6f 77  lobally..# allow
2330: 65 64 2e 0a 0a 09 69 66 20 7b 21 5b 6c 6c 65 6e  ed....if {![llen
2340: 67 74 68 20 24 61 72 67 73 5d 20 26 26 20 21 5b  gth $args] && ![
2350: 6d 79 20 68 61 73 64 65 66 61 75 6c 74 5d 20 26  my hasdefault] &
2360: 26 20 5b 63 6d 64 72 20 69 6e 74 65 72 61 63 74  & [cmdr interact
2370: 69 76 65 3f 5d 7d 20 7b 0a 09 20 20 20 20 23 20  ive?]} {..    # 
2380: 44 72 6f 70 20 69 6e 74 6f 20 61 20 73 68 65 6c  Drop into a shel
2390: 6c 20 77 68 65 72 65 20 74 68 65 20 75 73 65 72  l where the user
23a0: 20 63 61 6e 20 65 6e 74 65 72 20 68 65 72 20 63   can enter her c
23b0: 6f 6d 6d 61 6e 64 73 0a 09 20 20 20 20 23 20 69  ommands..    # i
23c0: 6e 74 65 72 61 63 74 69 76 65 6c 79 2e 0a 0a 09  nteractively....
23d0: 20 20 20 20 73 65 74 20 73 68 65 6c 6c 20 5b 6c      set shell [l
23e0: 69 6e 65 6e 6f 69 73 65 3a 3a 66 61 63 61 64 65  inenoise::facade
23f0: 20 6e 65 77 20 5b 73 65 6c 66 5d 5d 0a 09 20 20   new [self]]..  
2400: 20 20 73 65 74 20 6d 79 72 65 70 6c 65 78 69 74    set myreplexit
2410: 20 30 20 3b 20 23 20 49 6e 69 74 69 61 6c 69 7a   0 ; # Initializ
2420: 65 20 73 74 6f 70 20 73 69 67 6e 61 6c 2c 20 6e  e stop signal, n
2430: 6f 20 73 74 6f 70 70 69 6e 67 0a 09 20 20 20 20  o stopping..    
2440: 24 73 68 65 6c 6c 20 68 69 73 74 6f 72 79 20 31  $shell history 1
2450: 0a 09 20 20 20 20 5b 6d 79 20 72 6f 6f 74 5d 20  ..    [my root] 
2460: 73 65 74 20 2a 69 6e 2d 73 68 65 6c 6c 2a 20 74  set *in-shell* t
2470: 72 75 65 0a 09 20 20 20 20 24 73 68 65 6c 6c 20  rue..    $shell 
2480: 72 65 70 6c 0a 09 20 20 20 20 5b 6d 79 20 72 6f  repl..    [my ro
2490: 6f 74 5d 20 73 65 74 20 2a 69 6e 2d 73 68 65 6c  ot] set *in-shel
24a0: 6c 2a 20 66 61 6c 73 65 0a 09 20 20 20 20 24 73  l* false..    $s
24b0: 68 65 6c 6c 20 64 65 73 74 72 6f 79 0a 09 20 20  hell destroy..  
24c0: 20 20 72 65 74 75 72 6e 0a 09 7d 0a 0a 09 6d 79    return..}...my
24d0: 20 44 6f 20 7b 2a 7d 24 61 72 67 73 0a 09 72 65   Do {*}$args..re
24e0: 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20  turn.    }..    
24f0: 23 20 49 6e 74 65 72 6e 61 6c 2e 20 41 63 74 75  # Internal. Actu
2500: 61 6c 20 64 69 73 70 61 74 63 68 2e 20 53 68 61  al dispatch. Sha
2510: 72 65 64 20 62 79 20 6d 61 69 6e 20 65 6e 74 72  red by main entr
2520: 79 20 61 6e 64 20 73 68 65 6c 6c 2e 0a 20 20 20  y and shell..   
2530: 20 6d 65 74 68 6f 64 20 44 6f 20 7b 61 72 67 73   method Do {args
2540: 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d 64 72 2f  } {..debug.cmdr/
2550: 6f 66 66 69 63 65 72 20 7b 7d 0a 09 73 65 74 20  officer {}..set 
2560: 72 65 73 65 74 20 30 0a 09 69 66 20 7b 21 5b 6d  reset 0..if {![m
2570: 79 20 65 78 69 73 74 73 20 2a 63 6f 6d 6d 61 6e  y exists *comman
2580: 64 2a 5d 7d 20 7b 0a 09 20 20 20 20 6d 79 20 73  d*]} {..    my s
2590: 65 74 20 2a 63 6f 6d 6d 61 6e 64 2a 20 24 61 72  et *command* $ar
25a0: 67 73 0a 09 20 20 20 20 73 65 74 20 72 65 73 65  gs..    set rese
25b0: 74 20 31 0a 09 7d 0a 09 74 72 79 20 7b 0a 09 20  t 1..}..try {.. 
25c0: 20 20 20 23 20 45 6d 70 74 79 20 63 6f 6d 6d 61     # Empty comma
25d0: 6e 64 2e 20 44 65 6c 65 67 61 74 65 20 74 6f 20  nd. Delegate to 
25e0: 74 68 65 20 64 65 66 61 75 6c 74 2c 20 69 66 20  the default, if 
25f0: 77 65 20 68 61 76 65 20 61 6e 79 2e 0a 09 20 20  we have any...  
2600: 20 20 23 20 4f 74 68 65 72 77 69 73 65 20 66 61    # Otherwise fa
2610: 69 6c 2e 0a 09 20 20 20 20 69 66 20 7b 21 5b 6c  il...    if {![l
2620: 6c 65 6e 67 74 68 20 24 61 72 67 73 5d 7d 20 7b  length $args]} {
2630: 0a 09 09 69 66 20 7b 5b 6d 79 20 68 61 73 64 65  ...if {[my hasde
2640: 66 61 75 6c 74 5d 7d 20 7b 0a 09 09 20 20 20 20  fault]} {...    
2650: 72 65 74 75 72 6e 20 5b 5b 6d 79 20 6c 6f 6f 6b  return [[my look
2660: 75 70 20 5b 6d 79 20 64 65 66 61 75 6c 74 5d 5d  up [my default]]
2670: 20 64 6f 5d 0a 09 09 7d 0a 09 09 72 65 74 75 72   do]...}...retur
2680: 6e 20 2d 63 6f 64 65 20 65 72 72 6f 72 20 2d 65  n -code error -e
2690: 72 72 6f 72 63 6f 64 65 20 7b 43 4d 44 52 20 44  rrorcode {CMDR D
26a0: 4f 20 45 4d 50 54 59 7d 20 5c 0a 09 09 20 20 20  O EMPTY} \...   
26b0: 20 22 4e 6f 20 63 6f 6d 6d 61 6e 64 20 66 6f 75   "No command fou
26c0: 6e 64 2e 22 0a 09 20 20 20 20 7d 0a 0a 09 20 20  nd."..    }...  
26d0: 20 20 23 20 53 70 6c 69 74 20 69 6e 74 6f 20 63    # Split into c
26e0: 6f 6d 6d 61 6e 64 20 61 6e 64 20 61 72 67 75 6d  ommand and argum
26f0: 65 6e 74 73 0a 09 20 20 20 20 73 65 74 20 72 65  ents..    set re
2700: 6d 61 69 6e 64 65 72 20 5b 6c 61 73 73 69 67 6e  mainder [lassign
2710: 20 24 61 72 67 73 20 63 6d 64 5d 0a 0a 09 20 20   $args cmd]...  
2720: 20 20 23 20 44 65 6c 65 67 61 74 65 20 74 6f 20    # Delegate to 
2730: 74 68 65 20 68 61 6e 64 6c 65 72 20 66 6f 72 20  the handler for 
2740: 61 20 6b 6e 6f 77 6e 20 63 6f 6d 6d 61 6e 64 2e  a known command.
2750: 0a 09 20 20 20 20 69 66 20 7b 5b 6d 79 20 4b 6e  ..    if {[my Kn
2760: 6f 77 6e 20 24 63 6d 64 5d 7d 20 7b 0a 09 09 6d  own $cmd]} {...m
2770: 79 20 6c 61 70 70 65 6e 64 20 2a 70 72 65 66 69  y lappend *prefi
2780: 78 2a 20 24 63 6d 64 0a 09 09 5b 6d 79 20 6c 6f  x* $cmd...[my lo
2790: 6f 6b 75 70 20 24 63 6d 64 5d 20 64 6f 20 7b 2a  okup $cmd] do {*
27a0: 7d 24 72 65 6d 61 69 6e 64 65 72 0a 09 09 72 65  }$remainder...re
27b0: 74 75 72 6e 0a 09 20 20 20 20 7d 0a 0a 09 20 20  turn..    }...  
27c0: 20 20 23 20 54 68 65 20 63 6f 6d 6d 61 6e 64 20    # The command 
27d0: 77 6f 72 64 20 69 73 20 6e 6f 74 20 6b 6e 6f 77  word is not know
27e0: 6e 2e 20 44 65 6c 65 67 61 74 65 20 74 68 65 20  n. Delegate the 
27f0: 66 75 6c 6c 20 63 6f 6d 6d 61 6e 64 20 74 6f 0a  full command to.
2800: 09 20 20 20 20 23 20 74 68 65 20 64 65 66 61 75  .    # the defau
2810: 6c 74 2c 20 69 66 20 77 65 20 68 61 76 65 20 61  lt, if we have a
2820: 6e 79 2e 20 4f 74 68 65 72 77 69 73 65 20 66 61  ny. Otherwise fa
2830: 69 6c 2e 0a 0a 09 20 20 20 20 69 66 20 7b 5b 6d  il....    if {[m
2840: 79 20 68 61 73 64 65 66 61 75 6c 74 5d 7d 20 7b  y hasdefault]} {
2850: 0a 09 09 23 20 70 72 65 66 69 78 20 6c 65 66 74  ...# prefix left
2860: 20 61 73 20 69 73 2e 0a 09 09 72 65 74 75 72 6e   as is....return
2870: 20 5b 5b 6d 79 20 6c 6f 6f 6b 75 70 20 5b 6d 79   [[my lookup [my
2880: 20 64 65 66 61 75 6c 74 5d 5d 20 64 6f 20 7b 2a   default]] do {*
2890: 7d 24 61 72 67 73 5d 0a 09 20 20 20 20 7d 0a 0a  }$args]..    }..
28a0: 09 20 20 20 20 69 66 20 7b 5b 63 61 74 63 68 20  .    if {[catch 
28b0: 7b 0a 09 09 73 65 74 20 70 72 65 66 69 78 20 22  {...set prefix "
28c0: 20 5b 6d 79 20 67 65 74 20 2a 70 72 65 66 69 78   [my get *prefix
28d0: 2a 5d 20 22 0a 09 20 20 20 20 7d 5d 7d 20 7b 20  *] "..    }]} { 
28e0: 73 65 74 20 70 72 65 66 69 78 20 22 22 20 7d 0a  set prefix "" }.
28f0: 09 20 20 20 20 72 65 74 75 72 6e 20 2d 63 6f 64  .    return -cod
2900: 65 20 65 72 72 6f 72 20 5c 0a 09 09 2d 65 72 72  e error \...-err
2910: 6f 72 63 6f 64 65 20 5b 6c 69 73 74 20 43 4d 44  orcode [list CMD
2920: 52 20 44 4f 20 55 4e 4b 4e 4f 57 4e 20 24 63 6d  R DO UNKNOWN $cm
2930: 64 5d 20 5c 0a 09 09 22 55 6e 6b 6e 6f 77 6e 20  d] \..."Unknown 
2940: 63 6f 6d 6d 61 6e 64 20 5c 22 5b 73 74 72 69 6e  command \"[strin
2950: 67 20 74 72 69 6d 6c 65 66 74 20 24 70 72 65 66  g trimleft $pref
2960: 69 78 5d 24 63 6d 64 5c 22 2e 20 50 6c 65 61 73  ix]$cmd\". Pleas
2970: 65 20 75 73 65 20 27 68 65 6c 70 5b 73 74 72 69  e use 'help[stri
2980: 6e 67 20 74 72 69 6d 72 69 67 68 74 20 24 70 72  ng trimright $pr
2990: 65 66 69 78 5d 27 20 74 6f 20 73 65 65 20 74 68  efix]' to see th
29a0: 65 20 6c 69 73 74 20 6f 66 20 61 76 61 69 6c 61  e list of availa
29b0: 62 6c 65 20 63 6f 6d 6d 61 6e 64 73 2e 22 0a 09  ble commands."..
29c0: 7d 20 66 69 6e 61 6c 6c 79 20 7b 0a 09 20 20 20  } finally {..   
29d0: 20 69 66 20 7b 24 72 65 73 65 74 7d 20 7b 0a 09   if {$reset} {..
29e0: 09 6d 79 20 75 6e 73 65 74 20 2a 63 6f 6d 6d 61  .my unset *comma
29f0: 6e 64 2a 0a 09 20 20 20 20 7d 0a 09 20 20 20 20  nd*..    }..    
2a00: 6d 79 20 75 6e 73 65 74 20 2a 70 72 65 66 69 78  my unset *prefix
2a10: 2a 0a 09 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20  *..}.    }..    
2a20: 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23  # # ## ### #####
2a30: 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23   ######## ######
2a40: 23 23 23 23 23 23 23 0a 20 20 20 20 23 23 20 53  #######.    ## S
2a50: 68 65 6c 6c 20 68 6f 6f 6b 20 6d 65 74 68 6f 64  hell hook method
2a60: 73 20 63 61 6c 6c 65 64 20 62 79 20 74 68 65 20  s called by the 
2a70: 6c 69 6e 65 6e 6f 69 73 65 3a 3a 66 61 63 61 64  linenoise::facad
2a80: 65 2e 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 70  e...    method p
2a90: 72 6f 6d 70 74 31 20 20 20 7b 7d 20 20 20 20 20  rompt1   {}     
2aa0: 7b 20 72 65 74 75 72 6e 20 22 5b 6d 79 20 66 75  { return "[my fu
2ab0: 6c 6c 6e 61 6d 65 5d 20 3e 20 22 20 7d 0a 20 20  llname] > " }.  
2ac0: 20 20 6d 65 74 68 6f 64 20 70 72 6f 6d 70 74 32    method prompt2
2ad0: 20 20 20 7b 7d 20 20 20 20 20 7b 20 65 72 72 6f     {}     { erro
2ae0: 72 20 7b 43 6f 6e 74 69 6e 75 61 74 69 6f 6e 20  r {Continuation 
2af0: 6c 69 6e 65 73 20 61 72 65 20 6e 6f 74 20 73 75  lines are not su
2b00: 70 70 6f 72 74 65 64 7d 20 7d 0a 20 20 20 20 6d  pported} }.    m
2b10: 65 74 68 6f 64 20 63 6f 6e 74 69 6e 75 65 64 20  ethod continued 
2b20: 7b 6c 69 6e 65 7d 20 7b 20 72 65 74 75 72 6e 20  {line} { return 
2b30: 30 20 7d 0a 20 20 20 20 6d 65 74 68 6f 64 20 65  0 }.    method e
2b40: 78 69 74 20 20 20 20 20 20 7b 7d 20 20 20 20 20  xit      {}     
2b50: 7b 20 72 65 74 75 72 6e 20 24 6d 79 72 65 70 6c  { return $myrepl
2b60: 65 78 69 74 20 7d 0a 0a 20 20 20 20 6d 65 74 68  exit }..    meth
2b70: 6f 64 20 73 68 65 6c 6c 2d 65 78 69 74 20 7b 63  od shell-exit {c
2b80: 6f 6e 66 69 67 7d 20 7b 0a 09 23 20 4e 6f 20 61  onfig} {..# No a
2b90: 72 67 75 6d 65 6e 74 73 2c 20 69 67 6e 6f 72 65  rguments, ignore
2ba0: 20 63 6f 6e 66 69 67 2e 0a 09 73 65 74 20 6d 79   config...set my
2bb0: 72 65 70 6c 65 78 69 74 20 31 0a 09 72 65 74 75  replexit 1..retu
2bc0: 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6d 65  rn.    }..    me
2bd0: 74 68 6f 64 20 64 69 73 70 61 74 63 68 20 7b 63  thod dispatch {c
2be0: 6d 64 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d 64  md} {..debug.cmd
2bf0: 72 2f 6f 66 66 69 63 65 72 20 7b 7d 0a 0a 09 69  r/officer {}...i
2c00: 66 20 7b 24 63 6d 64 20 65 71 20 7b 7d 7d 20 7b  f {$cmd eq {}} {
2c10: 0a 09 20 20 20 20 23 20 4e 6f 20 63 6f 6d 6d 61  ..    # No comma
2c20: 6e 64 2c 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0a  nd, do nothing..
2c30: 09 20 20 20 20 72 65 74 75 72 6e 0a 09 7d 0a 0a  .    return..}..
2c40: 09 69 66 20 7b 24 63 6d 64 20 65 71 20 22 2e 65  .if {$cmd eq ".e
2c50: 78 69 74 22 7d 20 7b 0a 09 20 20 20 20 23 20 53  xit"} {..    # S
2c60: 65 65 20 6d 65 74 68 6f 64 20 27 73 68 65 6c 6c  ee method 'shell
2c70: 2d 65 78 69 74 27 20 61 73 20 77 65 6c 6c 2c 20  -exit' as well, 
2c80: 61 6e 64 20 27 53 65 74 75 70 27 20 66 6f 72 0a  and 'Setup' for.
2c90: 09 20 20 20 20 23 20 74 68 65 20 61 75 74 6f 2d  .    # the auto-
2ca0: 63 72 65 61 74 69 6f 6e 20 6f 66 20 61 6e 20 27  creation of an '
2cb0: 65 78 69 74 27 20 63 6f 6d 6d 61 6e 64 20 77 68  exit' command wh
2cc0: 65 6e 20 70 6f 73 73 69 62 6c 65 2c 0a 09 20 20  en possible,..  
2cd0: 20 20 23 20 69 2e 65 20 6e 6f 74 20 69 6e 20 63    # i.e not in c
2ce0: 6f 6e 66 6c 69 63 74 20 77 69 74 68 20 61 20 75  onflict with a u
2cf0: 73 65 72 2d 73 70 65 63 69 66 69 65 64 20 63 6f  ser-specified co
2d00: 6d 6d 61 6e 64 2e 0a 09 20 20 20 20 73 65 74 20  mmand...    set 
2d10: 6d 79 72 65 70 6c 65 78 69 74 20 31 20 3b 20 72  myreplexit 1 ; r
2d20: 65 74 75 72 6e 0a 09 7d 0a 09 6d 79 20 44 6f 20  eturn..}..my Do 
2d30: 7b 2a 7d 5b 73 74 72 69 6e 67 20 74 6f 6b 65 6e  {*}[string token
2d40: 20 73 68 65 6c 6c 20 24 63 6d 64 5d 0a 20 20 20   shell $cmd].   
2d50: 20 7d 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 72   }..    method r
2d60: 65 70 6f 72 74 20 7b 77 68 61 74 20 64 61 74 61  eport {what data
2d70: 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d 64 72 2f  } {..debug.cmdr/
2d80: 6f 66 66 69 63 65 72 20 7b 7d 0a 09 73 77 69 74  officer {}..swit
2d90: 63 68 20 2d 65 78 61 63 74 20 2d 2d 20 24 77 68  ch -exact -- $wh
2da0: 61 74 20 7b 0a 09 20 20 20 20 6f 6b 20 7b 0a 09  at {..    ok {..
2db0: 09 69 66 20 7b 24 64 61 74 61 20 65 71 20 7b 7d  .if {$data eq {}
2dc0: 7d 20 72 65 74 75 72 6e 0a 09 09 70 75 74 73 20  } return...puts 
2dd0: 73 74 64 6f 75 74 20 24 64 61 74 61 0a 09 20 20  stdout $data..  
2de0: 20 20 7d 0a 09 20 20 20 20 66 61 69 6c 20 7b 0a    }..    fail {.
2df0: 09 09 70 75 74 73 20 73 74 64 65 72 72 20 24 64  ..puts stderr $d
2e00: 61 74 61 0a 09 20 20 20 20 7d 0a 09 20 20 20 20  ata..    }..    
2e10: 64 65 66 61 75 6c 74 20 7b 0a 09 09 72 65 74 75  default {...retu
2e20: 72 6e 20 2d 63 6f 64 65 20 65 72 72 6f 72 20 5c  rn -code error \
2e30: 0a 09 09 20 20 20 20 22 49 6e 74 65 72 6e 61 6c  ...    "Internal
2e40: 20 65 72 72 6f 72 2c 20 62 61 64 20 72 65 73 75   error, bad resu
2e50: 6c 74 20 74 79 70 65 20 5c 22 24 77 68 61 74 5c  lt type \"$what\
2e60: 22 2c 20 65 78 70 65 63 74 65 64 20 6f 6b 2c 20  ", expected ok, 
2e70: 6f 72 20 66 61 69 6c 22 0a 09 20 20 20 20 7d 0a  or fail"..    }.
2e80: 09 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23 20  .}.    }..    # 
2e90: 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20 23  # ## ### ##### #
2ea0: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
2eb0: 23 23 23 23 23 0a 20 20 20 20 23 20 53 68 65 6c  #####.    # Shel
2ec0: 6c 20 68 6f 6f 6b 20 6d 65 74 68 6f 64 20 2d 20  l hook method - 
2ed0: 43 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 63 6f 6d  Command line com
2ee0: 70 6c 65 74 69 6f 6e 2e 0a 0a 20 20 20 20 6d 65  pletion...    me
2ef0: 74 68 6f 64 20 63 6f 6d 70 6c 65 74 65 20 7b 6c  thod complete {l
2f00: 69 6e 65 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d  ine} {..debug.cm
2f10: 64 72 2f 6f 66 66 69 63 65 72 20 7b 7d 20 31 30  dr/officer {} 10
2f20: 0a 09 23 70 75 74 73 20 73 74 64 65 72 72 20 2f  ..#puts stderr /
2f30: 2f 2f 2f 2f 2f 2f 2f 24 6c 69 6e 65 0a 09 74 72  ///////$line..tr
2f40: 79 20 7b 0a 09 20 20 20 20 73 65 74 20 63 6f 6d  y {..    set com
2f50: 70 6c 65 74 69 6f 6e 73 20 5b 6d 79 20 63 6f 6d  pletions [my com
2f60: 70 6c 65 74 65 2d 77 6f 72 64 73 20 5b 6d 79 20  plete-words [my 
2f70: 70 61 72 73 65 2d 6c 69 6e 65 20 24 6c 69 6e 65  parse-line $line
2f80: 5d 5d 0a 09 7d 20 6f 6e 20 65 72 72 6f 72 20 7b  ]]..} on error {
2f90: 65 20 6f 7d 20 7b 0a 09 20 20 20 20 70 75 74 73  e o} {..    puts
2fa0: 20 73 74 64 65 72 72 20 22 45 52 52 4f 52 3a 20   stderr "ERROR: 
2fb0: 24 65 22 0a 09 20 20 20 20 70 75 74 73 20 73 74  $e"..    puts st
2fc0: 64 65 72 72 20 24 3a 3a 65 72 72 6f 72 49 6e 66  derr $::errorInf
2fd0: 6f 0a 09 20 20 20 20 73 65 74 20 63 6f 6d 70 6c  o..    set compl
2fe0: 65 74 69 6f 6e 73 20 7b 7d 0a 09 7d 0a 09 23 70  etions {}..}..#p
2ff0: 75 74 73 20 73 74 64 65 72 72 20 3d 28 24 63 6f  uts stderr =($co
3000: 6d 70 6c 65 74 69 6f 6e 73 29 0a 09 72 65 74 75  mpletions)..retu
3010: 72 6e 20 24 63 6f 6d 70 6c 65 74 69 6f 6e 73 0a  rn $completions.
3020: 20 20 20 20 7d 0a 0a 20 20 20 20 6d 65 74 68 6f      }..    metho
3030: 64 20 63 6f 6d 70 6c 65 74 65 2d 77 6f 72 64 73  d complete-words
3040: 20 7b 70 61 72 73 65 7d 20 7b 0a 09 64 65 62 75   {parse} {..debu
3050: 67 2e 63 6d 64 72 2f 6f 66 66 69 63 65 72 20 7b  g.cmdr/officer {
3060: 7d 20 31 30 0a 09 23 70 75 74 73 20 73 74 64 65  } 10..#puts stde
3070: 72 72 20 5b 6d 79 20 66 75 6c 6c 6e 61 6d 65 5d  rr [my fullname]
3080: 2f 5b 73 65 6c 66 5d 2f 24 70 61 72 73 65 2f 0a  /[self]/$parse/.
3090: 09 23 20 4e 6f 74 65 3a 20 54 68 69 73 20 6d 65  .# Note: This me
30a0: 74 68 6f 64 20 68 61 73 20 74 6f 20 65 6e 74 72  thod has to entr
30b0: 79 2d 70 6f 69 6e 74 73 2e 0a 09 23 20 28 31 29  y-points...# (1)
30c0: 20 41 62 6f 76 65 20 69 6e 20 27 63 6f 6d 70 6c   Above in 'compl
30d0: 65 74 65 27 2c 20 66 6f 72 20 63 6f 6d 6d 61 6e  ete', for comman
30e0: 64 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 66 72 6f  d completion fro
30f0: 6d 20 73 65 6c 66 27 73 20 52 45 50 4c 2e 0a 09  m self's REPL...
3100: 23 20 28 32 29 20 42 65 6c 6f 77 2c 20 61 73 20  # (2) Below, as 
3110: 70 61 72 74 20 6f 66 20 72 65 63 75 72 73 69 6f  part of recursio
3120: 6e 20 66 72 6f 6d 20 61 20 68 69 67 68 65 72 20  n from a higher 
3130: 6f 66 66 69 63 65 72 20 77 68 69 6c 65 0a 09 23  officer while..#
3140: 20 20 20 20 20 66 6f 6c 6c 6f 77 69 6e 67 20 74       following t
3150: 68 65 20 63 68 61 69 6e 20 6f 66 20 77 6f 72 64  he chain of word
3160: 73 20 74 6f 20 74 68 65 20 61 63 74 6f 72 20 72  s to the actor r
3170: 65 73 70 6f 6e 73 69 62 6c 65 0a 09 23 20 20 20  esponsible..#   
3180: 20 20 66 6f 72 20 68 61 6e 64 6c 69 6e 67 20 74    for handling t
3190: 68 65 20 6c 61 73 74 20 77 6f 72 64 2e 0a 0a 09  he last word....
31a0: 6d 79 20 53 65 74 75 70 0a 0a 09 23 20 55 6e 66  my Setup...# Unf
31b0: 6f 6c 64 20 74 68 65 20 70 61 72 73 65 20 73 74  old the parse st
31c0: 61 74 65 0a 09 64 69 63 74 20 77 69 74 68 20 70  ate..dict with p
31d0: 61 72 73 65 20 7b 7d 20 3b 23 20 2d 2d 3e 20 6c  arse {} ;# --> l
31e0: 69 6e 65 20 6f 6b 20 77 6f 72 64 73 20 61 74 20  ine ok words at 
31f0: 6e 77 6f 72 64 73 20 64 6f 65 78 69 74 0a 09 23  nwords doexit..#
3200: 20 6f 6b 20 20 20 20 20 2d 20 62 6f 6f 6c 65 61   ok     - boolea
3210: 6e 20 66 6c 61 67 2c 20 73 79 6e 74 61 78 20 6f  n flag, syntax o
3220: 6b 20 3f 20 79 65 73 2f 6e 6f 0a 09 23 20 6c 69  k ? yes/no..# li
3230: 6e 65 20 20 20 2d 20 73 74 72 69 6e 67 2c 20 74  ne   - string, t
3240: 68 65 20 72 61 77 20 63 6f 6d 6d 61 6e 64 20 6c  he raw command l
3250: 69 6e 65 20 77 69 74 68 20 71 75 6f 74 65 73 2c  ine with quotes,
3260: 20 65 73 63 61 70 65 73 2c 20 65 74 63 2e 0a 09   escapes, etc...
3270: 23 20 6e 77 6f 72 64 73 20 2d 20 6e 75 6d 62 65  # nwords - numbe
3280: 72 20 6f 66 20 77 6f 72 64 73 20 66 6f 75 6e 64  r of words found
3290: 20 69 6e 20 74 68 65 20 2d 3e 20 6c 69 6e 65 0a   in the -> line.
32a0: 09 23 20 77 6f 72 64 73 20 20 2d 20 6c 69 73 74  .# words  - list
32b0: 20 6f 66 20 77 6f 72 64 73 20 66 6f 75 6e 64 20   of words found 
32c0: 69 6e 20 74 68 65 20 2d 3e 20 6c 69 6e 65 2e 0a  in the -> line..
32d0: 09 23 20 61 74 20 20 20 20 20 2d 20 69 6e 64 65  .# at     - inde
32e0: 78 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74  x of the current
32f0: 20 77 6f 72 64 20 74 6f 20 70 72 6f 63 65 73 73   word to process
3300: 2e 0a 09 23 20 64 6f 65 78 69 74 20 2d 20 62 6f  ...# doexit - bo
3310: 6f 6c 65 61 6e 20 66 6c 61 67 2c 20 70 73 65 75  olean flag, pseu
3320: 64 6f 2d 63 6f 6d 6d 61 6e 64 20 27 65 78 69 74  do-command 'exit
3330: 27 20 61 63 74 69 76 65 20 3f 20 79 65 73 2f 6e  ' active ? yes/n
3340: 6f 0a 09 23 0a 09 23 20 77 6f 72 64 73 20 3d 20  o..#..# words = 
3350: 6c 69 73 74 20 28 74 75 70 6c 65 29 2c 20 77 68  list (tuple), wh
3360: 65 72 65 20 74 75 70 6c 65 20 3d 20 28 74 79 70  ere tuple = (typ
3370: 65 20 73 74 61 72 74 6f 66 66 20 65 6e 64 6f 66  e startoff endof
3380: 66 20 73 74 72 69 6e 67 29 0a 09 23 20 64 6f 65  f string)..# doe
3390: 78 69 74 20 2d 20 54 72 75 65 20 6f 6e 6c 79 20  xit - True only 
33a0: 66 6f 72 20 65 6e 74 72 79 20 70 6f 69 6e 74 20  for entry point 
33b0: 28 31 29 2c 20 66 61 6c 73 65 20 66 6f 72 20 61  (1), false for a
33c0: 6c 6c 20 6f 66 20 28 32 29 20 61 6e 64 20 64 6f  ll of (2) and do
33d0: 77 6e 2e 0a 0a 09 23 20 50 61 72 73 65 20 65 72  wn....# Parse er
33e0: 72 6f 72 2c 20 62 61 64 20 73 79 6e 74 61 78 2e  ror, bad syntax.
33f0: 20 4e 6f 20 63 6f 6d 70 6c 65 74 69 6f 6e 73 2e   No completions.
3400: 0a 0a 09 69 66 20 7b 21 24 6f 6b 7d 20 7b 0a 09  ...if {!$ok} {..
3410: 20 20 20 20 23 70 75 74 73 20 73 74 64 65 72 72      #puts stderr
3420: 20 5c 74 42 41 44 0a 09 20 20 20 20 72 65 74 75   \tBAD..    retu
3430: 72 6e 20 7b 7d 0a 09 7d 0a 0a 09 23 20 45 6d 70  rn {}..}...# Emp
3440: 74 79 20 6c 69 6e 65 2e 20 41 6c 6c 20 6f 75 72  ty line. All our
3450: 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 63 6f   commands are co
3460: 6d 70 6c 65 74 69 6f 6e 73 2c 20 70 6c 75 73 20  mpletions, plus 
3470: 74 68 65 0a 09 23 20 73 70 65 63 69 61 6c 20 27  the..# special '
3480: 2e 65 78 69 74 27 20 63 6f 6d 6d 61 6e 64 20 74  .exit' command t
3490: 6f 20 73 74 6f 70 20 74 68 65 20 52 45 50 4c 2e  o stop the REPL.
34a0: 20 54 68 75 73 20 75 73 69 6e 67 0a 09 23 20 6d   Thus using..# m
34b0: 79 3c 63 3e 63 6f 6d 6d 61 6e 64 73 20 69 6e 73  y<c>commands ins
34c0: 74 65 61 64 20 6f 66 20 6d 79 63 6f 6d 6d 61 6e  tead of mycomman
34d0: 64 73 2e 0a 0a 09 69 66 20 7b 24 6c 69 6e 65 20  ds....if {$line 
34e0: 65 71 20 7b 7d 7d 20 7b 0a 09 20 20 20 20 23 70  eq {}} {..    #p
34f0: 75 74 73 20 73 74 64 65 72 72 20 5c 74 41 4c 4c  uts stderr \tALL
3500: 0a 09 20 20 20 20 73 65 74 20 63 6f 6d 70 6c 65  ..    set comple
3510: 74 69 6f 6e 73 20 5b 6d 79 20 43 43 6f 6d 6d 61  tions [my CComma
3520: 6e 64 73 5d 0a 09 20 20 20 20 69 66 20 7b 5b 6d  nds]..    if {[m
3530: 79 20 68 61 73 64 65 66 61 75 6c 74 5d 7d 20 7b  y hasdefault]} {
3540: 0a 09 09 64 69 63 74 20 73 65 74 20 70 61 72 73  ...dict set pars
3550: 65 20 64 6f 65 78 69 74 20 30 0a 09 09 6c 61 70  e doexit 0...lap
3560: 70 65 6e 64 20 63 6f 6d 70 6c 65 74 69 6f 6e 73  pend completions
3570: 20 7b 2a 7d 5b 5b 6d 79 20 6c 6f 6f 6b 75 70 20   {*}[[my lookup 
3580: 5b 6d 79 20 64 65 66 61 75 6c 74 5d 5d 20 63 6f  [my default]] co
3590: 6d 70 6c 65 74 65 2d 77 6f 72 64 73 20 24 70 61  mplete-words $pa
35a0: 72 73 65 5d 0a 09 20 20 20 20 7d 0a 09 20 20 20  rse]..    }..   
35b0: 20 72 65 74 75 72 6e 20 5b 6c 73 6f 72 74 20 2d   return [lsort -
35c0: 75 6e 69 71 75 65 20 5b 6c 73 6f 72 74 20 2d 64  unique [lsort -d
35d0: 69 63 74 20 24 63 6f 6d 70 6c 65 74 69 6f 6e 73  ict $completions
35e0: 5d 5d 0a 09 7d 0a 0a 09 23 20 42 65 79 6f 6e 64  ]]..}...# Beyond
35f0: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20   the end of the 
3600: 6c 69 6e 65 2e 20 4e 6f 20 63 6f 6d 70 6c 65 74  line. No complet
3610: 69 6f 6e 73 2e 0a 0a 09 69 66 20 7b 24 61 74 20  ions....if {$at 
3620: 3d 3d 20 24 6e 77 6f 72 64 73 7d 20 7b 0a 09 20  == $nwords} {.. 
3630: 20 20 20 23 70 75 74 73 20 73 74 64 65 72 72 20     #puts stderr 
3640: 5c 74 42 45 59 4f 4e 44 0a 09 20 20 20 20 72 65  \tBEYOND..    re
3650: 74 75 72 6e 20 7b 7d 0a 09 7d 0a 0a 09 69 66 20  turn {}..}...if 
3660: 7b 24 61 74 20 3c 20 28 24 6e 77 6f 72 64 73 20  {$at < ($nwords 
3670: 2d 20 31 29 7d 20 7b 0a 09 20 20 20 20 23 20 54  - 1)} {..    # T
3680: 68 69 73 20 6f 66 66 69 63 65 72 20 68 61 73 20  his officer has 
3690: 74 6f 20 68 61 6e 64 6c 65 20 61 20 77 6f 72 64  to handle a word
36a0: 20 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 20 6f   in the middle o
36b0: 66 20 74 68 65 0a 09 20 20 20 20 23 20 63 6f 6d  f the..    # com
36c0: 6d 61 6e 64 20 6c 69 6e 65 2e 20 54 68 69 73 20  mand line. This 
36d0: 69 73 20 64 6f 6e 65 20 62 79 20 64 65 6c 65 67  is done by deleg
36e0: 61 74 69 6e 67 20 74 6f 20 74 68 65 0a 09 20 20  ating to the..  
36f0: 20 20 23 20 73 75 62 6f 72 64 69 6e 61 74 65 20    # subordinate 
3700: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
3710: 74 68 65 20 63 75 72 72 65 6e 74 20 77 6f 72 64  the current word
3720: 20 61 6e 64 20 6c 65 74 74 69 6e 67 0a 09 20 20   and letting..  
3730: 20 20 23 20 69 74 20 68 61 6e 64 6c 65 20 74 68    # it handle th
3740: 65 20 72 65 6d 61 69 6e 64 65 72 2e 0a 0a 09 20  e remainder.... 
3750: 20 20 20 23 70 75 74 73 20 73 74 64 65 72 72 20     #puts stderr 
3760: 5c 74 52 45 43 55 52 53 45 0a 09 20 20 20 20 72  \tRECURSE..    r
3770: 65 74 75 72 6e 20 5b 6d 79 20 43 6f 6d 70 6c 65  eturn [my Comple
3780: 74 65 52 65 63 75 72 73 65 20 24 70 61 72 73 65  teRecurse $parse
3790: 5d 0a 09 7d 0a 0a 09 23 20 54 68 69 73 20 6f 66  ]..}...# This of
37a0: 66 69 63 65 72 20 69 73 20 72 65 73 70 6f 6e 73  ficer is respons
37b0: 69 62 6c 65 20 66 6f 72 20 68 61 6e 64 6c 69 6e  ible for handlin
37c0: 67 20 74 68 65 20 6c 61 73 74 20 77 6f 72 64 20  g the last word 
37d0: 6f 6e 0a 09 23 20 74 68 65 20 63 6f 6d 6d 61 6e  on..# the comman
37e0: 64 20 6c 69 6e 65 2e 20 57 65 20 64 6f 20 74 68  d line. We do th
37f0: 69 73 20 62 79 20 63 6f 6d 70 75 74 69 6e 67 20  is by computing 
3800: 74 68 65 20 73 65 74 20 6f 66 0a 09 23 20 6d 61  the set of..# ma
3810: 74 63 68 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20  tching commands 
3820: 66 72 6f 6d 20 74 68 65 20 73 65 74 20 74 68 65  from the set the
3830: 20 6f 66 66 69 63 65 72 20 6b 6e 6f 77 73 20 61   officer knows a
3840: 6e 64 0a 09 23 20 70 72 6f 76 69 64 69 6e 67 20  nd..# providing 
3850: 74 68 65 6d 20 61 73 20 63 6f 6d 70 6c 65 74 69  them as completi
3860: 6f 6e 73 2e 20 4f 6e 65 20 74 72 69 63 6b 79 20  ons. One tricky 
3870: 74 68 69 6e 67 3a 20 49 66 20 77 65 20 68 61 76  thing: If we hav
3880: 65 0a 09 23 20 61 20 64 65 66 61 75 6c 74 20 77  e..# a default w
3890: 65 20 61 73 6b 20 69 74 20 61 73 20 77 65 6c 6c  e ask it as well
38a0: 2c 20 61 6e 64 20 6d 65 72 67 65 20 69 74 73 20  , and merge its 
38b0: 63 6f 6d 70 6c 65 74 69 6f 6e 73 20 74 6f 0a 09  completions to..
38c0: 23 20 6f 75 72 73 2e 20 4c 61 73 74 6c 79 2c 20  # ours. Lastly, 
38d0: 77 65 20 6d 61 79 20 68 61 76 65 20 74 6f 20 61  we may have to a
38e0: 64 64 20 74 68 65 20 27 2e 65 78 69 74 27 20 70  dd the '.exit' p
38f0: 73 65 75 64 6f 2d 63 6f 6d 6d 61 6e 64 0a 09 23  seudo-command..#
3900: 20 61 73 20 77 65 6c 6c 2e 0a 0a 09 23 70 75 74   as well....#put
3910: 73 20 73 74 64 65 72 72 20 5c 74 4d 41 54 43 48  s stderr \tMATCH
3920: 5c 20 28 5b 6c 69 6e 64 65 78 20 24 77 6f 72 64  \ ([lindex $word
3930: 73 20 24 61 74 20 65 6e 64 5d 29 0a 0a 09 73 65  s $at end])...se
3940: 74 20 63 6f 6d 6d 61 6e 64 73 20 5b 6d 79 20 43  t commands [my C
3950: 43 6f 6d 6d 61 6e 64 73 20 24 64 6f 65 78 69 74  Commands $doexit
3960: 5d 0a 0a 09 73 65 74 20 63 6f 6d 70 6c 65 74 69  ]...set completi
3970: 6f 6e 73 20 5c 0a 09 20 20 20 20 5b 6d 79 20 63  ons \..    [my c
3980: 6f 6d 70 6c 65 74 69 6f 6e 73 20 24 70 61 72 73  ompletions $pars
3990: 65 20 5c 0a 09 09 20 5b 6d 79 20 6d 61 74 63 68  e \... [my match
39a0: 20 24 70 61 72 73 65 20 24 63 6f 6d 6d 61 6e 64   $parse $command
39b0: 73 5d 5d 0a 0a 09 69 66 20 7b 5b 6d 79 20 68 61  s]]...if {[my ha
39c0: 73 64 65 66 61 75 6c 74 5d 7d 20 7b 0a 09 20 20  sdefault]} {..  
39d0: 20 20 64 69 63 74 20 73 65 74 20 70 61 72 73 65    dict set parse
39e0: 20 64 6f 65 78 69 74 20 30 0a 09 20 20 20 20 6c   doexit 0..    l
39f0: 61 70 70 65 6e 64 20 63 6f 6d 70 6c 65 74 69 6f  append completio
3a00: 6e 73 20 7b 2a 7d 5b 5b 6d 79 20 6c 6f 6f 6b 75  ns {*}[[my looku
3a10: 70 20 5b 6d 79 20 64 65 66 61 75 6c 74 5d 5d 20  p [my default]] 
3a20: 63 6f 6d 70 6c 65 74 65 2d 77 6f 72 64 73 20 24  complete-words $
3a30: 70 61 72 73 65 5d 0a 09 7d 0a 0a 09 23 70 75 74  parse]..}...#put
3a40: 73 20 73 74 64 65 72 72 20 5c 74 43 28 24 63 6f  s stderr \tC($co
3a50: 6d 70 6c 65 74 69 6f 6e 73 29 0a 09 72 65 74 75  mpletions)..retu
3a60: 72 6e 20 5b 6c 73 6f 72 74 20 2d 75 6e 69 71 75  rn [lsort -uniqu
3a70: 65 20 5b 6c 73 6f 72 74 20 2d 64 69 63 74 20 24  e [lsort -dict $
3a80: 63 6f 6d 70 6c 65 74 69 6f 6e 73 5d 5d 0a 20 20  completions]].  
3a90: 20 20 7d 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20    }..    method 
3aa0: 43 6f 6d 70 6c 65 74 65 52 65 63 75 72 73 65 20  CompleteRecurse 
3ab0: 7b 70 61 72 73 65 7d 20 7b 0a 09 64 65 62 75 67  {parse} {..debug
3ac0: 2e 63 6d 64 72 2f 6f 66 66 69 63 65 72 20 7b 7d  .cmdr/officer {}
3ad0: 20 31 30 0a 09 23 20 49 6e 73 69 64 65 20 74 68   10..# Inside th
3ae0: 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2e 20  e command line. 
3af0: 46 69 6e 64 20 74 68 65 20 72 65 6c 65 76 61 6e  Find the relevan
3b00: 74 20 73 75 62 6f 72 64 69 6e 61 74 65 20 62 61  t subordinate ba
3b10: 73 65 64 0a 09 23 20 6f 6e 20 74 68 65 20 63 75  sed..# on the cu
3b20: 72 72 65 6e 74 20 77 6f 72 64 20 61 6e 64 20 6c  rrent word and l
3b30: 65 74 20 69 74 20 68 61 6e 64 6c 65 20 65 76 65  et it handle eve
3b40: 72 79 74 68 69 6e 67 2e 0a 0a 09 23 20 54 68 65  rything....# The
3b50: 20 27 2e 65 78 69 74 27 20 70 73 65 75 64 6f 2d   '.exit' pseudo-
3b60: 63 6f 6d 6d 61 6e 64 20 6f 66 20 74 68 65 20 73  command of the s
3b70: 75 62 6f 72 64 69 6e 61 74 65 20 69 73 20 69 72  ubordinate is ir
3b80: 72 65 6c 65 76 61 6e 74 0a 09 23 20 64 75 72 69  relevant..# duri
3b90: 6e 67 20 72 65 63 75 72 73 69 6f 6e 20 66 72 6f  ng recursion fro
3ba0: 6d 20 74 68 65 20 63 75 72 72 65 6e 74 20 6f 72  m the current or
3bb0: 20 68 69 67 68 65 72 20 52 45 50 4c 2c 20 73 75   higher REPL, su
3bc0: 70 70 72 65 73 73 0a 09 23 20 69 74 2e 20 54 68  ppress..# it. Th
3bd0: 65 20 70 73 65 75 64 6f 2d 63 6f 6d 6d 61 6e 64  e pseudo-command
3be0: 20 69 73 20 6f 6e 6c 79 20 72 65 6c 65 76 61 6e   is only relevan
3bf0: 74 20 74 6f 20 74 68 65 20 6f 66 66 69 63 65 72  t to the officer
3c00: 73 0a 09 23 20 61 63 74 75 61 6c 6c 79 20 69 6e  s..# actually in
3c10: 20 74 68 65 69 72 20 52 45 50 4c 2e 0a 09 64 69   their REPL...di
3c20: 63 74 20 73 65 74 20 70 61 72 73 65 20 64 6f 65  ct set parse doe
3c30: 78 69 74 20 30 0a 0a 09 73 65 74 20 6d 61 74 63  xit 0...set matc
3c40: 68 65 73 20 5b 6d 79 20 6d 61 74 63 68 20 24 70  hes [my match $p
3c50: 61 72 73 65 20 5b 6d 79 20 6b 6e 6f 77 6e 5d 5d  arse [my known]]
3c60: 0a 0a 09 69 66 20 7b 5b 6c 6c 65 6e 67 74 68 20  ...if {[llength 
3c70: 24 6d 61 74 63 68 65 73 5d 20 3d 3d 20 31 7d 20  $matches] == 1} 
3c80: 7b 0a 09 20 20 20 20 23 20 50 72 6f 70 65 72 20  {..    # Proper 
3c90: 73 75 62 6f 72 64 69 6e 61 74 65 20 66 6f 75 6e  subordinate foun
3ca0: 64 2e 20 44 65 6c 65 67 61 74 65 2e 20 4e 6f 74  d. Delegate. Not
3cb0: 65 3a 20 53 74 65 70 20 74 6f 20 6e 65 78 74 0a  e: Step to next.
3cc0: 09 20 20 20 20 23 20 77 6f 72 64 2c 20 77 65 20  .    # word, we 
3cd0: 68 61 76 65 20 70 72 6f 63 65 73 73 65 64 20 74  have processed t
3ce0: 68 65 20 63 75 72 72 65 6e 74 20 6f 6e 65 2e 0a  he current one..
3cf0: 09 20 20 20 20 64 69 63 74 20 69 6e 63 72 20 70  .    dict incr p
3d00: 61 72 73 65 20 61 74 0a 09 20 20 20 20 73 65 74  arse at..    set
3d10: 20 68 61 6e 64 6c 65 72 20 5b 6d 79 20 6c 6f 6f   handler [my loo
3d20: 6b 75 70 20 5b 6c 69 6e 64 65 78 20 24 6d 61 74  kup [lindex $mat
3d30: 63 68 65 73 20 30 5d 5d 0a 09 20 20 20 20 72 65  ches 0]]..    re
3d40: 74 75 72 6e 20 5b 24 68 61 6e 64 6c 65 72 20 63  turn [$handler c
3d50: 6f 6d 70 6c 65 74 65 2d 77 6f 72 64 73 20 24 70  omplete-words $p
3d60: 61 72 73 65 5d 0a 09 7d 0a 0a 09 23 20 54 68 65  arse]..}...# The
3d70: 20 73 65 61 72 63 68 20 77 61 73 20 69 6e 63 6f   search was inco
3d80: 6e 63 6c 75 73 69 76 65 2e 20 54 72 79 20 74 68  nclusive. Try th
3d90: 65 20 64 65 66 61 75 6c 74 2c 20 69 66 20 77 65  e default, if we
3da0: 20 68 61 76 65 20 61 6e 79 2e 0a 09 69 66 20 7b   have any...if {
3db0: 5b 6d 79 20 68 61 73 64 65 66 61 75 6c 74 5d 7d  [my hasdefault]}
3dc0: 20 7b 0a 09 20 20 20 20 72 65 74 75 72 6e 20 5b   {..    return [
3dd0: 5b 6d 79 20 6c 6f 6f 6b 75 70 20 5b 6d 79 20 64  [my lookup [my d
3de0: 65 66 61 75 6c 74 5d 5d 20 63 6f 6d 70 6c 65 74  efault]] complet
3df0: 65 2d 77 6f 72 64 73 20 24 70 61 72 73 65 5d 0a  e-words $parse].
3e00: 09 7d 0a 0a 09 23 20 4e 6f 20 64 65 66 61 75 6c  .}...# No defaul
3e10: 74 2c 20 6e 6f 20 63 6f 6d 70 6c 65 74 69 6f 6e  t, no completion
3e20: 73 2e 0a 09 72 65 74 75 72 6e 20 7b 7d 0a 20 20  s...return {}.  
3e30: 20 20 7d 0a 0a 20 20 20 20 23 20 23 20 23 23 20    }..    # # ## 
3e40: 23 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23  ### ##### ######
3e50: 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23  ## #############
3e60: 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 43 43 6f  ..    method CCo
3e70: 6d 6d 61 6e 64 73 20 7b 7b 64 6f 65 78 69 74 20  mmands {{doexit 
3e80: 31 7d 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d 64  1}} {..debug.cmd
3e90: 72 2f 6f 66 66 69 63 65 72 20 7b 7d 20 31 30 0a  r/officer {} 10.
3ea0: 09 69 66 20 7b 21 5b 6c 6c 65 6e 67 74 68 20 24  .if {![llength $
3eb0: 6d 79 63 63 6f 6d 6d 61 6e 64 73 5d 7d 20 7b 0a  myccommands]} {.
3ec0: 09 20 20 20 20 23 20 46 69 6c 6c 20 63 6f 6d 70  .    # Fill comp
3ed0: 6c 65 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 20 63  letion command c
3ee0: 61 63 68 65 2e 0a 0a 09 20 20 20 20 23 20 53 74  ache....    # St
3ef0: 61 6e 64 61 72 64 20 70 73 65 75 64 6f 2d 63 6f  andard pseudo-co
3f00: 6d 6d 61 6e 64 73 2e 0a 09 20 20 20 20 69 66 20  mmands...    if 
3f10: 7b 24 64 6f 65 78 69 74 7d 20 7b 0a 09 09 6c 61  {$doexit} {...la
3f20: 70 70 65 6e 64 20 6d 79 63 63 6f 6d 6d 61 6e 64  ppend myccommand
3f30: 73 20 2e 65 78 69 74 0a 09 20 20 20 20 7d 0a 0a  s .exit..    }..
3f40: 09 20 20 20 20 66 6f 72 65 61 63 68 20 63 20 24  .    foreach c $
3f50: 6d 79 63 6f 6d 6d 61 6e 64 73 20 7b 0a 09 09 23  mycommands {...#
3f60: 20 55 6e 64 6f 63 75 6d 65 6e 74 65 64 20 63 6f   Undocumented co
3f70: 6d 6d 61 6e 64 73 20 61 72 65 20 6e 6f 74 20 61  mmands are not a
3f80: 76 61 69 6c 61 62 6c 65 20 74 6f 20 63 6f 6d 70  vailable to comp
3f90: 6c 65 74 69 6f 6e 2e 0a 09 09 69 66 20 7b 21 5b  letion....if {![
3fa0: 5b 6d 79 20 6c 6f 6f 6b 75 70 20 24 63 5d 20 64  [my lookup $c] d
3fb0: 6f 63 75 6d 65 6e 74 65 64 5d 7d 20 63 6f 6e 74  ocumented]} cont
3fc0: 69 6e 75 65 0a 09 09 6c 61 70 70 65 6e 64 20 6d  inue...lappend m
3fd0: 79 63 63 6f 6d 6d 61 6e 64 73 20 24 63 0a 09 20  yccommands $c.. 
3fe0: 20 20 20 7d 0a 0a 09 20 20 20 20 73 65 74 20 6d     }...    set m
3ff0: 79 63 63 6f 6d 6d 61 6e 64 73 20 5b 6c 73 6f 72  yccommands [lsor
4000: 74 20 2d 75 6e 69 71 75 65 20 5b 6c 73 6f 72 74  t -unique [lsort
4010: 20 2d 64 69 63 74 20 24 6d 79 63 63 6f 6d 6d 61   -dict $myccomma
4020: 6e 64 73 5d 5d 0a 09 7d 0a 0a 09 72 65 74 75 72  nds]]..}...retur
4030: 6e 20 24 6d 79 63 63 6f 6d 6d 61 6e 64 73 0a 20  n $myccommands. 
4040: 20 20 20 7d 0a 0a 0a 20 20 20 20 23 20 23 20 23     }...    # # #
4050: 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23  # ### ##### ####
4060: 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23  #### ###########
4070: 23 23 0a 0a 20 20 20 20 6d 65 74 68 6f 64 20 68  ##..    method h
4080: 65 6c 70 20 7b 7b 70 72 65 66 69 78 20 7b 7d 7d  elp {{prefix {}}
4090: 7d 20 7b 0a 09 64 65 62 75 67 2e 63 6d 64 72 2f  } {..debug.cmdr/
40a0: 6f 66 66 69 63 65 72 20 7b 7d 0a 09 6d 79 20 53  officer {}..my S
40b0: 65 74 75 70 0a 09 23 20 51 75 65 72 79 20 65 61  etup..# Query ea
40c0: 63 68 20 73 75 62 6f 72 64 69 6e 61 74 65 20 66  ch subordinate f
40d0: 6f 72 20 74 68 65 69 72 20 68 65 6c 70 20 61 6e  or their help an
40e0: 64 20 75 73 65 20 69 74 20 74 6f 20 70 69 65 63  d use it to piec
40f0: 65 20 6f 75 72 73 20 74 6f 67 65 74 68 65 72 2e  e ours together.
4100: 0a 09 23 20 4e 6f 74 65 3a 20 52 65 73 75 6c 74  ..# Note: Result
4110: 20 69 73 20 6e 6f 74 20 66 69 6e 61 6c 6c 79 20   is not finally 
4120: 66 6f 72 6d 61 74 74 65 64 20 74 65 78 74 2c 20  formatted text, 
4130: 62 75 74 20 6e 65 73 74 65 64 20 64 69 63 74 20  but nested dict 
4140: 73 74 72 75 63 74 75 72 65 2e 0a 09 23 20 53 61  structure...# Sa
4150: 6d 65 20 69 73 20 65 78 70 65 63 74 65 64 20 66  me is expected f
4160: 72 6f 6d 20 74 68 65 20 73 75 62 2d 6f 72 64 69  rom the sub-ordi
4170: 6e 61 74 65 73 0a 0a 09 23 20 68 65 6c 70 20 3d  nates...# help =
4180: 20 64 69 63 74 20 28 6e 61 6d 65 20 2d 3e 20 63   dict (name -> c
4190: 6f 6d 6d 61 6e 64 29 0a 09 23 69 66 20 7b 21 5b  ommand)..#if {![
41a0: 6d 79 20 64 6f 63 75 6d 65 6e 74 65 64 5d 7d 20  my documented]} 
41b0: 7b 20 72 65 74 75 72 6e 20 7b 7d 20 7d 0a 09 73  { return {} }..s
41c0: 65 74 20 68 65 6c 70 20 7b 7d 0a 09 66 6f 72 65  et help {}..fore
41d0: 61 63 68 20 63 20 5b 6d 79 20 6b 6e 6f 77 6e 5d  ach c [my known]
41e0: 20 7b 0a 09 20 20 20 20 73 65 74 20 63 6e 61 6d   {..    set cnam
41f0: 65 20 5b 6c 69 73 74 20 7b 2a 7d 24 70 72 65 66  e [list {*}$pref
4200: 69 78 20 24 63 5d 0a 09 20 20 20 20 73 65 74 20  ix $c]..    set 
4210: 61 63 74 6f 72 20 5b 6d 79 20 6c 6f 6f 6b 75 70  actor [my lookup
4220: 20 24 63 5d 0a 09 20 20 20 20 69 66 20 7b 21 5b   $c]..    if {![
4230: 24 61 63 74 6f 72 20 64 6f 63 75 6d 65 6e 74 65  $actor documente
4240: 64 5d 7d 20 63 6f 6e 74 69 6e 75 65 0a 09 20 20  d]} continue..  
4250: 20 20 73 65 74 20 68 65 6c 70 20 5b 64 69 63 74    set help [dict
4260: 20 6d 65 72 67 65 20 24 68 65 6c 70 20 5b 24 61   merge $help [$a
4270: 63 74 6f 72 20 68 65 6c 70 20 24 63 6e 61 6d 65  ctor help $cname
4280: 5d 5d 0a 09 7d 0a 09 72 65 74 75 72 6e 20 24 68  ]]..}..return $h
4290: 65 6c 70 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23  elp.    }..    #
42a0: 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20   # ## ### ##### 
42b0: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
42c0: 23 23 23 23 23 23 0a 0a 20 20 20 20 76 61 72 69  ######..    vari
42d0: 61 62 6c 65 20 6d 79 69 6e 69 74 20 6d 79 61 63  able myinit myac
42e0: 74 69 6f 6e 73 20 6d 79 6d 61 70 20 6d 79 63 6f  tions mymap myco
42f0: 6d 6d 61 6e 64 73 20 6d 79 63 63 6f 6d 6d 61 6e  mmands myccomman
4300: 64 73 20 6d 79 63 68 69 6c 64 72 65 6e 20 5c 0a  ds mychildren \.
4310: 09 6d 79 72 65 70 6c 65 78 69 74 20 6d 79 68 61  .myreplexit myha
4320: 6e 64 6c 65 72 0a 0a 20 20 20 20 23 20 23 20 23  ndler..    # # #
4330: 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23  # ### ##### ####
4340: 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23  #### ###########
4350: 23 23 0a 7d 0a 0a 23 20 23 20 23 23 20 23 23 23  ##.}..# # ## ###
4360: 20 23 23 23 23 23 20 23 23 23 23 23 23 23 23 20   ##### ######## 
4370: 23 23 23 23 23 23 23 23 23 23 23 23 23 20 23 23  ############# ##
4380: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
4390: 23 23 23 0a 23 23 20 52 65 61 64 79 0a 70 61 63  ###.## Ready.pac
43a0: 6b 61 67 65 20 70 72 6f 76 69 64 65 20 63 6d 64  kage provide cmd
43b0: 72 3a 3a 6f 66 66 69 63 65 72 20 31 2e 30 0a     r::officer 1.0.