Hex Artifact Content
Not logged in

Artifact 25cdb5647d22b388aaa8a3a27099e2545e3f8c36:


0000: 2e 54 48 20 74 63 6c 72 65 61 64 6c 69 6e 65 20  .TH tclreadline 
0010: 6e 20 22 40 54 43 4c 52 45 41 44 4c 49 4e 45 5f  n "@TCLREADLINE_
0020: 56 45 52 53 49 4f 4e 40 22 20 22 4a 6f 68 61 6e  VERSION@" "Johan
0030: 6e 65 73 20 5a 65 6c 6c 6e 65 72 22 0a 0a 2e 5c  nes Zellner"...\
0040: 22 20 28 43 29 20 31 39 39 39 20 62 79 20 4a 6f  " (C) 1999 by Jo
0050: 68 61 6e 6e 65 73 20 5a 65 6c 6c 6e 65 72 0a 2e  hannes Zellner..
0060: 5c 22 20 46 49 4c 45 3a 20 22 2f 68 6f 6d 65 2f  \" FILE: "/home/
0070: 6a 6f 7a 65 2f 73 72 63 2f 74 63 6c 72 65 61 64  joze/src/tclread
0080: 6c 69 6e 65 2f 74 63 6c 72 65 61 64 6c 69 6e 65  line/tclreadline
0090: 2e 6e 2e 69 6e 22 0a 2e 5c 22 20 4c 41 53 54 20  .n.in"..\" LAST 
00a0: 4d 4f 44 49 46 49 43 41 54 49 4f 4e 3a 20 22 4d  MODIFICATION: "M
00b0: 6f 6e 20 41 75 67 20 32 33 20 32 32 3a 33 31 3a  on Aug 23 22:31:
00c0: 32 34 20 31 39 39 39 20 28 6a 6f 7a 65 29 22 0a  24 1999 (joze)".
00d0: 2e 5c 22 20 28 43 29 20 31 39 39 38 2c 20 31 39  .\" (C) 1998, 19
00e0: 39 39 20 62 79 20 4a 6f 68 61 6e 6e 65 73 20 5a  99 by Johannes Z
00f0: 65 6c 6c 6e 65 72 2c 20 3c 6a 6f 68 61 6e 6e 65  ellner, <johanne
0100: 73 40 7a 65 6c 6c 6e 65 72 2e 6f 72 67 3e 0a 2e  s@zellner.org>..
0110: 5c 22 20 24 49 64 24 0a 2e 5c 22 20 2d 2d 2d 0a  \" $Id$..\" ---.
0120: 2e 5c 22 0a 2e 5c 22 20 74 63 6c 72 65 61 64 6c  .\"..\" tclreadl
0130: 69 6e 65 20 2d 2d 20 67 6e 75 20 72 65 61 64 6c  ine -- gnu readl
0140: 69 6e 65 20 66 6f 72 20 74 68 65 20 74 63 6c 20  ine for the tcl 
0150: 73 63 72 69 70 74 69 6e 67 20 6c 61 6e 67 75 61  scripting langua
0160: 67 65 0a 2e 5c 22 20 43 6f 70 79 72 69 67 68 74  ge..\" Copyright
0170: 20 28 43 29 20 31 39 39 39 20 20 4a 6f 68 61 6e   (C) 1999  Johan
0180: 6e 65 73 20 5a 65 6c 6c 6e 65 72 0a 2e 5c 22 0a  nes Zellner..\".
0190: 2e 5c 22 20 54 68 69 73 20 70 72 6f 67 72 61 6d  .\" This program
01a0: 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61 72   is free softwar
01b0: 65 3b 20 79 6f 75 20 63 61 6e 20 72 65 64 69 73  e; you can redis
01c0: 74 72 69 62 75 74 65 20 69 74 20 61 6e 64 2f 6f  tribute it and/o
01d0: 72 0a 2e 5c 22 20 6d 6f 64 69 66 79 20 69 74 20  r..\" modify it 
01e0: 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20  under the terms 
01f0: 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72  of the GNU Gener
0200: 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73  al Public Licens
0210: 65 0a 2e 5c 22 20 61 73 20 70 75 62 6c 69 73 68  e..\" as publish
0220: 65 64 20 62 79 20 74 68 65 20 46 72 65 65 20 53  ed by the Free S
0230: 6f 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69  oftware Foundati
0240: 6f 6e 3b 20 65 69 74 68 65 72 20 76 65 72 73 69  on; either versi
0250: 6f 6e 20 32 0a 2e 5c 22 20 6f 66 20 74 68 65 20  on 2..\" of the 
0260: 4c 69 63 65 6e 73 65 2c 20 6f 72 20 28 61 74 20  License, or (at 
0270: 79 6f 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79  your option) any
0280: 20 6c 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a   later version..
0290: 2e 5c 22 0a 2e 5c 22 20 54 68 69 73 20 70 72 6f  .\"..\" This pro
02a0: 67 72 61 6d 20 69 73 20 64 69 73 74 72 69 62 75  gram is distribu
02b0: 74 65 64 20 69 6e 20 74 68 65 20 68 6f 70 65 20  ted in the hope 
02c0: 74 68 61 74 20 69 74 20 77 69 6c 6c 20 62 65 20  that it will be 
02d0: 75 73 65 66 75 6c 2c 0a 2e 5c 22 20 62 75 74 20  useful,..\" but 
02e0: 57 49 54 48 4f 55 54 20 41 4e 59 20 57 41 52 52  WITHOUT ANY WARR
02f0: 41 4e 54 59 3b 20 77 69 74 68 6f 75 74 20 65 76  ANTY; without ev
0300: 65 6e 20 74 68 65 20 69 6d 70 6c 69 65 64 20 77  en the implied w
0310: 61 72 72 61 6e 74 79 20 6f 66 0a 2e 5c 22 20 4d  arranty of..\" M
0320: 45 52 43 48 41 4e 54 41 42 49 4c 49 54 59 20 6f  ERCHANTABILITY o
0330: 72 20 46 49 54 4e 45 53 53 20 46 4f 52 20 41 20  r FITNESS FOR A 
0340: 50 41 52 54 49 43 55 4c 41 52 20 50 55 52 50 4f  PARTICULAR PURPO
0350: 53 45 2e 20 20 53 65 65 20 74 68 65 0a 2e 5c 22  SE.  See the..\"
0360: 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62   GNU General Pub
0370: 6c 69 63 20 4c 69 63 65 6e 73 65 20 66 6f 72 20  lic License for 
0380: 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 0a 2e 5c  more details...\
0390: 22 0a 2e 5c 22 20 59 6f 75 20 73 68 6f 75 6c 64  "..\" You should
03a0: 20 68 61 76 65 20 72 65 63 65 69 76 65 64 20 61   have received a
03b0: 20 63 6f 70 79 20 6f 66 20 74 68 65 20 47 4e 55   copy of the GNU
03c0: 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20   General Public 
03d0: 4c 69 63 65 6e 73 65 0a 2e 5c 22 20 61 6c 6f 6e  License..\" alon
03e0: 67 20 77 69 74 68 20 74 68 69 73 20 70 72 6f 67  g with this prog
03f0: 72 61 6d 3b 20 69 66 20 6e 6f 74 2c 20 77 72 69  ram; if not, wri
0400: 74 65 20 74 6f 20 74 68 65 20 46 72 65 65 20 53  te to the Free S
0410: 6f 66 74 77 61 72 65 0a 2e 5c 22 20 46 6f 75 6e  oftware..\" Foun
0420: 64 61 74 69 6f 6e 2c 20 49 6e 63 2e 2c 20 35 39  dation, Inc., 59
0430: 20 54 65 6d 70 6c 65 20 50 6c 61 63 65 20 2d 20   Temple Place - 
0440: 53 75 69 74 65 20 33 33 30 2c 20 42 6f 73 74 6f  Suite 330, Bosto
0450: 6e 2c 20 4d 41 20 20 30 32 31 31 31 2d 31 33 30  n, MA  02111-130
0460: 37 2c 20 55 53 41 2e 0a 2e 5c 22 0a 2e 5c 22 20  7, USA...\"..\" 
0470: 3c 6a 6f 68 61 6e 6e 65 73 40 7a 65 6c 6c 6e 65  <johannes@zellne
0480: 72 2e 6f 72 67 3e 2c 20 68 74 74 70 3a 2f 2f 77  r.org>, http://w
0490: 77 77 2e 7a 65 6c 6c 6e 65 72 2e 6f 72 67 2f 74  ww.zellner.org/t
04a0: 63 6c 72 65 61 64 6c 69 6e 65 2f 0a 0a 0a 2e 5c  clreadline/....\
04b0: 22 09 23 20 43 53 20 2d 20 62 65 67 69 6e 20 63  ".# CS - begin c
04c0: 6f 64 65 20 65 78 63 65 72 70 74 0a 2e 64 65 20  ode excerpt..de 
04d0: 43 53 0a 2e 52 53 0a 2e 6e 66 0a 2e 74 61 20 2e  CS..RS..nf..ta .
04e0: 32 35 69 20 2e 35 69 20 2e 37 35 69 20 31 69 0a  25i .5i .75i 1i.
04f0: 2e 2e 0a 2e 5c 22 09 23 20 43 45 20 2d 20 65 6e  ....\".# CE - en
0500: 64 20 63 6f 64 65 20 65 78 63 65 72 70 74 0a 2e  d code excerpt..
0510: 64 65 20 43 45 0a 2e 66 69 0a 2e 52 45 0a 2e 2e  de CE..fi..RE...
0520: 0a 0a 2e 53 48 20 22 4e 41 4d 45 22 0a 74 63 6c  ...SH "NAME".tcl
0530: 72 65 61 64 6c 69 6e 65 20 5c 2d 20 67 6e 75 20  readline \- gnu 
0540: 72 65 61 64 6c 69 6e 65 20 66 6f 72 20 74 68 65  readline for the
0550: 20 74 63 6c 20 73 63 72 69 70 74 69 6e 67 20 6c   tcl scripting l
0560: 61 6e 67 75 61 67 65 0a 0a 2e 53 48 20 22 53 59  anguage...SH "SY
0570: 4e 4f 50 53 49 53 22 0a 2e 54 50 20 36 0a 5c 66  NOPSIS"..TP 6.\f
0580: 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a  B::tclreadline::
0590: 72 65 61 64 6c 69 6e 65 5c 66 50 20 5c 66 49 63  readline\fP \fIc
05a0: 6f 6d 6d 61 6e 64 5c 66 50 20 5b 5c 66 49 6f 70  ommand\fP [\fIop
05b0: 74 69 6f 6e 73 5c 66 50 5d 0a 0a 0a 2e 53 48 20  tions\fP]....SH 
05c0: 22 44 45 53 43 52 49 50 54 49 4f 4e 22 0a 0a 54  "DESCRIPTION"..T
05d0: 68 65 20 5c 66 42 74 63 6c 72 65 61 64 6c 69 6e  he \fBtclreadlin
05e0: 65 5c 66 50 20 70 61 63 6b 61 67 65 20 6d 61 6b  e\fP package mak
05f0: 65 73 20 74 68 65 20 67 6e 75 20 72 65 61 64 6c  es the gnu readl
0600: 69 6e 65 20 61 76 61 69 6c 61 62 6c 65 0a 74 6f  ine available.to
0610: 20 74 68 65 20 73 63 72 69 70 74 69 6e 67 20 6c   the scripting l
0620: 61 6e 67 75 61 67 65 20 74 63 6c 2e 20 54 68 65  anguage tcl. The
0630: 20 70 72 69 6d 61 72 79 20 70 75 72 70 6f 73 65   primary purpose
0640: 20 6f 66 20 74 68 65 20 70 61 63 6b 61 67 65 0a   of the package.
0650: 69 73 20 74 6f 20 66 61 63 69 6c 69 74 61 74 65  is to facilitate
0660: 20 74 68 65 20 69 6e 74 65 72 61 63 74 69 76 65   the interactive
0670: 20 73 63 72 69 70 74 20 64 65 76 65 6c 6f 70 6d   script developm
0680: 65 6e 74 20 62 79 20 74 68 65 20 6d 65 61 6e 73  ent by the means
0690: 0a 6f 66 20 77 6f 72 64 20 61 6e 64 20 66 69 6c  .of word and fil
06a0: 65 20 6e 61 6d 65 20 63 6f 6d 70 6c 65 74 69 6f  e name completio
06b0: 6e 20 61 73 20 77 65 6c 6c 20 61 73 20 68 69 73  n as well as his
06c0: 74 6f 72 79 20 65 78 70 61 6e 73 69 6f 6e 0a 28  tory expansion.(
06d0: 77 65 6c 6c 20 6b 6e 6f 77 6e 20 66 72 6f 6d 20  well known from 
06e0: 73 68 65 6c 6c 73 20 6c 69 6b 65 20 62 61 73 68  shells like bash
06f0: 29 2e 0a 0a 41 64 64 69 74 69 6f 6e 61 6c 6c 79  )...Additionally
0700: 20 74 63 6c 72 65 61 64 6c 69 6e 65 20 63 61 6e   tclreadline can
0710: 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 66 6f   also be used fo
0720: 72 20 74 63 6c 20 73 63 72 69 70 74 73 0a 77 68  r tcl scripts.wh
0730: 69 63 68 20 77 61 6e 74 20 74 6f 20 75 73 65 20  ich want to use 
0740: 61 20 73 68 65 6c 6c 20 6c 69 6b 65 20 69 6e 70  a shell like inp
0750: 75 74 20 69 6e 74 65 72 66 61 63 65 2e 20 49 6e  ut interface. In
0760: 20 74 68 69 73 20 63 61 73 65 20 74 68 65 0a 5c   this case the.\
0770: 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a  fB::tclreadline:
0780: 3a 72 65 61 64 6c 69 6e 65 20 72 65 61 64 5c 66  :readline read\f
0790: 50 20 63 6f 6d 6d 61 6e 64 20 68 61 73 20 74 6f  P command has to
07a0: 20 62 65 20 63 61 6c 6c 65 64 20 65 78 70 6c 69   be called expli
07b0: 63 69 74 6c 79 2e 0a 0a 2e 50 50 0a 0a 54 68 65  citly....PP..The
07c0: 20 61 64 76 61 6e 74 61 67 65 20 6f 66 20 5c 66   advantage of \f
07d0: 42 74 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50 20  Btclreadline\fP 
07e0: 69 73 20 74 68 61 74 20 69 74 20 75 73 65 73 20  is that it uses 
07f0: 74 68 65 20 63 61 6c 6c 62 61 63 6b 0a 68 61 6e  the callback.han
0800: 64 6c 65 72 20 6d 65 63 68 61 6e 69 73 6d 20 6f  dler mechanism o
0810: 66 20 74 68 65 20 67 6e 75 20 72 65 61 64 6c 69  f the gnu readli
0820: 6e 65 20 77 68 69 6c 65 20 69 74 20 70 72 6f 63  ne while it proc
0830: 65 73 73 65 73 20 74 63 6c 0a 65 76 65 6e 74 73  esses tcl.events
0840: 2e 20 54 68 69 73 20 77 61 79 20 58 20 65 76 65  . This way X eve
0850: 6e 74 73 20 66 72 6f 6d 20 61 20 77 69 73 68 20  nts from a wish 
0860: 67 75 69 20 77 69 6c 6c 20 70 72 6f 63 65 73 73  gui will process
0870: 65 64 20 61 73 0a 77 65 6c 6c 20 61 73 20 65 76  ed as.well as ev
0880: 65 6e 74 73 20 66 72 6f 6d 20 74 68 65 20 5c 66  ents from the \f
0890: 50 74 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50 20  Ptclreadline\fP 
08a0: 6c 69 6e 65 20 69 6e 74 65 72 66 61 63 65 2e 0a  line interface..
08b0: 0a 2e 50 50 0a 0a 5c 66 42 74 63 6c 72 65 61 64  ..PP..\fBtclread
08c0: 6c 69 6e 65 5c 66 50 20 69 73 20 62 61 73 69 63  line\fP is basic
08d0: 61 6c 6c 79 20 61 20 73 68 61 72 65 64 20 6c 69  ally a shared li
08e0: 62 72 61 72 79 20 61 6e 64 20 61 20 66 65 77 20  brary and a few 
08f0: 74 63 6c 20 73 63 72 69 70 74 73 0a 77 68 69 63  tcl scripts.whic
0900: 68 20 61 72 65 20 61 63 63 65 73 73 65 64 20 77  h are accessed w
0910: 69 74 68 20 74 68 65 20 74 63 6c 20 70 61 63 6b  ith the tcl pack
0920: 61 67 65 20 72 65 71 75 69 72 65 20 63 6f 6d 6d  age require comm
0930: 61 6e 64 2e 20 54 68 65 72 65 66 6f 72 65 0a 5c  and. Therefore.\
0940: 66 42 74 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50  fBtclreadline\fP
0950: 20 73 68 6f 75 6c 64 20 77 6f 72 6b 20 77 69 74   should work wit
0960: 68 20 61 6c 6c 20 63 6f 6d 6d 6f 6e 20 65 78 74  h all common ext
0970: 65 6e 73 69 6f 6e 73 20 6c 69 6b 65 0a 5c 66 42  ensions like.\fB
0980: 62 6c 74 2c 20 69 74 63 6c 2c 20 69 74 6b 2c 20  blt, itcl, itk, 
0990: 74 69 78 20 2e 2e 2e 5c 66 50 2e 0a 0a 0a 2e 5c  tix ...\fP.....\
09a0: 22 20 2e 53 48 20 53 4f 55 52 43 45 20 46 49 4c  " .SH SOURCE FIL
09b0: 45 53 0a 0a 0a 2e 53 48 20 22 43 4f 4d 4d 41 4e  ES....SH "COMMAN
09c0: 44 53 22 0a 0a 49 66 20 79 6f 75 20 77 61 6e 74  DS"..If you want
09d0: 20 74 6f 20 75 73 65 20 5c 66 42 74 63 6c 72 65   to use \fBtclre
09e0: 61 64 6c 69 6e 65 5c 66 50 20 61 73 20 61 20 6c  adline\fP as a l
09f0: 69 6e 65 20 69 6e 74 65 72 66 61 63 65 0a 66 6f  ine interface.fo
0a00: 72 20 64 65 76 65 6c 6f 70 69 6e 67 20 74 63 6c  r developing tcl
0a10: 20 73 63 72 69 70 74 73 2c 20 79 6f 75 20 70 72   scripts, you pr
0a20: 6f 62 61 62 6c 79 20 64 6f 6e 27 74 20 68 61 76  obably don't hav
0a30: 65 20 74 6f 20 72 65 61 64 0a 74 68 69 73 20 73  e to read.this s
0a40: 65 63 74 69 6f 6e 2e 0a 0a 2e 50 50 0a 54 68 65  ection....PP.The
0a50: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6c 69 73 74 20   following list 
0a60: 77 69 6c 6c 20 67 69 76 65 20 61 6c 6c 20 63 6f  will give all co
0a70: 6d 6d 61 6e 64 73 2c 20 77 68 69 63 68 20 61 72  mmands, which ar
0a80: 65 20 63 75 72 72 65 6e 74 6c 79 0a 69 6d 70 6c  e currently.impl
0a90: 65 6d 65 6e 74 65 64 20 69 6e 20 74 68 65 20 73  emented in the s
0aa0: 68 61 72 65 64 20 6c 69 62 20 28 65 2e 67 2e 20  hared lib (e.g. 
0ab0: 6c 69 62 74 63 6c 72 65 61 64 6c 69 6e 65 40 54  libtclreadline@T
0ac0: 43 4c 52 45 41 44 4c 49 4e 45 5f 56 45 52 53 49  CLREADLINE_VERSI
0ad0: 4f 4e 40 2e 73 6f 29 2e 0a 41 64 64 69 74 69 6f  ON@.so)..Additio
0ae0: 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 77 65 72  nal commands wer
0af0: 65 20 69 6e 74 72 6f 64 75 63 65 64 20 69 6e 20  e introduced in 
0b00: 61 20 73 74 61 72 74 75 70 20 73 63 72 69 70 74  a startup script
0b10: 0a 5c 66 42 74 63 6c 72 65 61 64 6c 69 6e 65 53  .\fBtclreadlineS
0b20: 65 74 75 70 2e 74 63 6c 5c 66 50 2c 20 77 68 69  etup.tcl\fP, whi
0b30: 63 68 20 6c 69 76 65 73 20 69 6e 20 74 68 65 20  ch lives in the 
0b40: 74 63 6c 72 65 61 64 6c 69 6e 65 0a 69 6e 73 74  tclreadline.inst
0b50: 61 6c 6c 61 74 69 6f 6e 20 64 69 72 65 63 74 6f  allation directo
0b60: 72 79 2e 0a 28 74 79 70 69 63 61 6c 6c 79 20 73  ry..(typically s
0b70: 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 2f 75  omething like /u
0b80: 73 72 2f 6c 6f 63 61 6c 2f 6c 69 62 2f 74 63 6c  sr/local/lib/tcl
0b90: 72 65 61 64 6c 69 6e 65 20 2e 2e 29 0a 54 68 65  readline ..).The
0ba0: 73 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20  se commands are 
0bb0: 70 72 69 6d 61 72 69 6c 79 20 66 6f 72 20 69 6e  primarily for in
0bc0: 74 65 72 6e 61 6c 20 75 73 65 20 61 6e 64 20 6e  ternal use and n
0bd0: 6f 74 20 64 6f 63 75 6d 65 6e 74 65 64 20 68 65  ot documented he
0be0: 72 65 2e 0a 0a 4e 6f 74 65 20 74 68 61 74 20 61  re...Note that a
0bf0: 6c 6c 20 63 6f 6d 6d 61 6e 64 73 20 72 65 73 69  ll commands resi
0c00: 64 65 20 69 6e 20 74 68 65 20 6e 61 6d 65 73 70  de in the namesp
0c10: 61 63 65 20 5c 66 42 3a 3a 74 63 6c 72 65 61 64  ace \fB::tclread
0c20: 6c 69 6e 65 3a 3a 5c 66 50 2e 0a 0a 0a 2e 54 50  line::\fP.....TP
0c30: 20 35 0a 5c 66 42 3a 3a 74 63 6c 72 65 61 64 6c   5.\fB::tclreadl
0c40: 69 6e 65 3a 3a 72 65 61 64 6c 69 6e 65 20 61 64  ine::readline ad
0c50: 64 5c 66 50 20 5c 66 49 73 74 72 69 6e 67 5c 66  d\fP \fIstring\f
0c60: 50 0a 61 64 64 73 20 61 20 73 74 72 69 6e 67 20  P.adds a string 
0c70: 74 6f 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 72  to the completer
0c80: 2e 20 49 66 20 74 68 65 20 73 74 72 69 6e 67 20  . If the string 
0c90: 63 6f 6e 74 61 69 6e 73 20 77 68 69 74 65 0a 73  contains white.s
0ca0: 70 61 63 65 73 2c 20 65 61 63 68 20 6f 66 20 74  paces, each of t
0cb0: 68 65 20 77 6f 72 64 73 20 77 69 6c 6c 20 62 65  he words will be
0cc0: 20 63 6f 6d 70 6c 65 74 65 64 20 63 6f 6e 73 65   completed conse
0cd0: 63 75 74 69 76 65 6c 79 20 77 68 65 6e 0a 68 69  cutively when.hi
0ce0: 74 74 69 6e 67 20 3c 54 61 62 3e 2e 20 45 78 61  tting <Tab>. Exa
0cf0: 6d 70 6c 65 3a 0a 0a 20 20 20 20 3a 3a 74 63 6c  mple:..    ::tcl
0d00: 72 65 61 64 6c 69 6e 65 3a 3a 72 65 61 64 6c 69  readline::readli
0d10: 6e 65 20 61 64 64 20 22 62 75 74 74 6f 6e 20 70  ne add "button p
0d20: 61 74 68 4e 61 6d 65 20 3f 6f 70 74 69 6f 6e 73  athName ?options
0d30: 3f 22 0a 0a 74 79 70 69 6e 67 20 62 75 74 3c 54  ?"..typing but<T
0d40: 61 62 3e 20 77 69 6c 6c 20 63 6f 6d 70 6c 65 74  ab> will complet
0d50: 65 20 74 6f 20 62 75 74 74 6f 6e 2e 20 48 69 74  e to button. Hit
0d60: 74 69 6e 67 20 3c 54 61 62 3e 20 61 67 61 69 6e  ting <Tab> again
0d70: 0a 77 69 6c 6c 20 63 6f 6d 70 6c 65 74 65 20 74  .will complete t
0d80: 6f 20 22 62 75 74 74 6f 6e 20 70 61 74 68 4e 61  o "button pathNa
0d90: 6d 65 22 2e 20 20 2e 2e 2e 0a 0a 2e 54 50 20 35  me".  ......TP 5
0da0: 0a 5c 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e  .\fB::tclreadlin
0db0: 65 3a 3a 72 65 61 64 6c 69 6e 65 20 63 6f 6d 70  e::readline comp
0dc0: 6c 65 74 65 5c 66 50 20 5c 66 49 73 74 72 69 6e  lete\fP \fIstrin
0dd0: 67 5c 66 50 0a 72 65 74 75 72 6e 73 20 31 20 69  g\fP.returns 1 i
0de0: 66 20 5c 66 49 73 74 72 69 6e 67 5c 66 50 20 69  f \fIstring\fP i
0df0: 73 20 61 20 63 6f 6d 70 6c 65 74 65 20 74 63 6c  s a complete tcl
0e00: 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 30 20 6f   command and 0 o
0e10: 74 68 65 72 77 69 73 65 2e 0a 0a 2e 54 50 20 35  therwise....TP 5
0e20: 0a 5c 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e  .\fB::tclreadlin
0e30: 65 3a 3a 72 65 61 64 6c 69 6e 65 20 63 75 73 74  e::readline cust
0e40: 6f 6d 63 6f 6d 70 6c 65 74 65 72 5c 66 50 20 5b  omcompleter\fP [
0e50: 5c 66 49 73 74 72 69 6e 67 5c 66 50 5d 0a 52 65  \fIstring\fP].Re
0e60: 67 69 73 74 65 72 20 74 68 65 20 70 72 6f 63 20  gister the proc 
0e70: 5c 66 49 73 74 72 69 6e 67 5c 66 50 20 61 73 20  \fIstring\fP as 
0e80: 63 75 73 74 6f 6d 20 63 6f 6d 70 6c 65 74 65 72  custom completer
0e90: 2e 20 54 68 69 73 20 70 72 6f 63 20 69 73 20 63  . This proc is c
0ea0: 61 6c 6c 65 64 0a 77 69 74 68 20 65 78 61 63 74  alled.with exact
0eb0: 6c 79 20 66 6f 75 72 20 61 72 67 75 6d 65 6e 74  ly four argument
0ec0: 73 20 65 61 63 68 20 74 69 6d 65 20 63 6f 6d 70  s each time comp
0ed0: 6c 65 74 69 6f 6e 20 74 61 6b 65 73 20 70 6c 61  letion takes pla
0ee0: 63 65 3a 0a 74 68 65 20 77 6f 72 64 20 74 6f 20  ce:.the word to 
0ef0: 63 6f 6d 70 6c 65 74 65 20 28 22 74 65 78 74 22  complete ("text"
0f00: 29 2c 20 74 68 65 20 22 73 74 61 72 74 22 20 61  ), the "start" a
0f10: 6e 64 20 22 65 6e 64 22 20 70 6f 73 69 74 69 6f  nd "end" positio
0f20: 6e 73 20 6f 66 20 74 68 69 73 20 77 6f 72 64 0a  ns of this word.
0f30: 69 6e 20 74 68 65 20 6c 69 6e 65 20 65 6e 74 65  in the line ente
0f40: 72 65 64 20 73 6f 20 66 61 72 2c 20 61 6e 64 20  red so far, and 
0f50: 74 68 69 73 20 6c 69 6e 65 20 28 22 6c 69 6e 65  this line ("line
0f60: 22 29 2e 20 54 68 65 20 63 75 73 74 6f 6d 20 63  "). The custom c
0f70: 6f 6d 70 6c 65 74 69 6f 6e 0a 73 63 72 69 70 74  ompletion.script
0f80: 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 61   should return a
0f90: 6e 20 61 72 72 61 79 20 6f 66 20 73 74 72 69 6e  n array of strin
0fa0: 67 73 20 77 68 69 63 68 20 69 73 20 61 20 6c 69  gs which is a li
0fb0: 73 74 20 6f 66 20 63 6f 6d 70 6c 65 74 69 6f 6e  st of completion
0fc0: 73 0a 66 6f 72 20 22 74 65 78 74 22 2e 20 20 49  s.for "text".  I
0fd0: 66 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 63  f there are no c
0fe0: 6f 6d 70 6c 65 74 69 6f 6e 73 2c 20 69 74 20 73  ompletions, it s
0ff0: 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 61 6e 20  hould return an 
1000: 65 6d 70 74 79 0a 73 74 72 69 6e 67 20 22 22 2e  empty.string "".
1010: 20 20 54 68 65 20 66 69 72 73 74 20 65 6e 74 72    The first entr
1020: 79 20 69 6e 20 74 68 65 20 72 65 74 75 72 6e 65  y in the returne
1030: 64 20 6c 69 73 74 20 69 73 20 74 68 65 20 73 75  d list is the su
1040: 62 73 74 69 74 75 74 69 6f 6e 0a 66 6f 72 20 22  bstitution.for "
1050: 74 65 78 74 22 2e 20 54 68 65 20 72 65 6d 61 69  text". The remai
1060: 6e 69 6e 67 20 65 6e 74 72 69 65 73 20 61 72 65  ning entries are
1070: 20 74 68 65 20 70 6f 73 73 69 62 6c 65 20 63 6f   the possible co
1080: 6d 70 6c 65 74 69 6f 6e 73 2e 20 49 66 0a 74 68  mpletions. If.th
1090: 65 20 63 75 73 74 6f 6d 20 63 6f 6d 70 6c 65 74  e custom complet
10a0: 69 6f 6e 20 73 63 72 69 70 74 20 72 65 74 75 72  ion script retur
10b0: 6e 73 20 61 6e 20 65 6d 70 74 79 20 73 74 72 69  ns an empty stri
10c0: 6e 67 20 61 6e 64 20 62 75 69 6c 74 69 6e 0a 63  ng and builtin.c
10d0: 6f 6d 70 6c 65 74 69 6f 6e 20 69 73 20 65 6e 61  ompletion is ena
10e0: 62 6c 65 64 20 28 73 65 65 20 5c 66 42 74 63 6c  bled (see \fBtcl
10f0: 72 65 61 64 6c 69 6e 65 3a 3a 72 65 61 64 6c 69  readline::readli
1100: 6e 65 20 62 75 69 6c 74 69 6e 63 6f 6d 70 6c 65  ne builtincomple
1110: 74 65 72 5c 66 50 29 2c 0a 74 68 65 20 62 75 69  ter\fP),.the bui
1120: 6c 74 69 6e 20 63 6f 6d 70 6c 65 74 65 72 20 69  ltin completer i
1130: 73 20 63 61 6c 6c 65 64 2e 0a 5c 66 42 74 63 6c  s called..\fBtcl
1140: 72 65 61 64 6c 69 6e 65 3a 3a 72 65 61 64 6c 69  readline::readli
1150: 6e 65 20 63 75 73 74 6f 6d 63 6f 6d 70 6c 65 74  ne customcomplet
1160: 65 72 5c 66 50 20 73 69 6d 70 6c 79 20 72 65 74  er\fP simply ret
1170: 75 72 6e 73 20 74 68 65 20 63 75 72 72 65 6e 74  urns the current
1180: 0a 63 75 73 74 6f 6d 20 63 6f 6d 70 6c 65 74 65  .custom complete
1190: 72 20 69 66 20 63 61 6c 6c 65 64 20 77 2f 6f 20  r if called w/o 
11a0: 5c 66 49 73 74 72 69 6e 67 5c 66 50 2e 20 54 6f  \fIstring\fP. To
11b0: 20 74 75 72 6e 20 6f 66 20 63 75 73 74 6f 6d 0a   turn of custom.
11c0: 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 63 61 6c 6c  completion, call
11d0: 20 5c 66 42 74 63 6c 72 65 61 64 6c 69 6e 65 3a   \fBtclreadline:
11e0: 3a 72 65 61 64 6c 69 6e 65 20 63 75 73 74 6f 6d  :readline custom
11f0: 63 6f 6d 70 6c 65 74 65 72 5c 66 50 20 77 69 74  completer\fP wit
1200: 68 0a 61 6e 20 65 6d 70 74 79 20 5c 66 49 73 74  h.an empty \fIst
1210: 72 69 6e 67 5c 66 50 2e 0a 0a 45 78 61 6d 70 6c  ring\fP...Exampl
1220: 65 3a 20 5c 66 42 25 20 70 75 74 73 20 24 62 3c  e: \fB% puts $b<
1230: 54 41 42 3e 5c 66 50 20 77 69 6c 6c 20 63 61 6c  TAB>\fP will cal
1240: 6c 20 74 68 65 20 63 75 73 74 6f 6d 20 63 6f 6d  l the custom com
1250: 70 6c 65 74 65 72 0a 77 69 74 68 20 74 68 65 20  pleter.with the 
1260: 66 6f 75 72 20 61 72 67 75 6d 65 6e 74 73 20 5c  four arguments \
1270: 66 49 22 24 62 22 5c 66 50 2c 20 5c 66 49 22 35  fI"$b"\fP, \fI"5
1280: 22 5c 66 50 2c 20 5c 66 49 22 38 22 5c 66 50 20  "\fP, \fI"8"\fP 
1290: 61 6e 64 20 5c 66 49 22 70 75 74 73 20 24 62 22  and \fI"puts $b"
12a0: 5c 66 50 2e 0a 54 68 65 20 63 75 73 74 6f 6d 20  \fP..The custom 
12b0: 63 6f 6d 70 6c 65 74 65 72 20 63 6f 75 6c 64 20  completer could 
12c0: 72 65 74 75 72 6e 20 61 20 73 74 72 69 6e 67 20  return a string 
12d0: 6c 69 6b 65 20 22 24 62 6c 20 24 62 6c 61 63 6b  like "$bl $black
12e0: 20 24 62 6c 75 65 22 2c 20 77 68 69 63 68 0a 77   $blue", which.w
12f0: 69 6c 6c 20 63 6f 6d 70 6c 65 74 65 20 22 24 62  ill complete "$b
1300: 22 20 74 6f 20 22 24 62 6c 22 20 28 74 68 65 20  " to "$bl" (the 
1310: 6c 6f 6e 67 65 73 74 20 6d 61 74 63 68 29 20 61  longest match) a
1320: 6e 64 20 6f 66 66 65 72 20 61 20 6c 69 73 74 20  nd offer a list 
1330: 6f 66 20 74 77 6f 0a 66 75 72 74 68 65 72 20 6d  of two.further m
1340: 61 74 63 68 65 73 20 22 24 62 6c 61 63 6b 22 20  atches "$black" 
1350: 61 6e 64 20 22 24 62 6c 75 65 22 2e 0a 0a 46 6f  and "$blue"...Fo
1360: 72 20 66 75 72 74 68 65 72 20 72 65 66 65 72 65  r further refere
1370: 6e 63 65 2c 20 73 65 65 20 74 68 65 20 70 72 6f  nce, see the pro
1380: 63 20 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 53  c tclreadline::S
1390: 63 72 69 70 74 43 6f 6d 70 6c 65 74 65 72 20 69  criptCompleter i
13a0: 6e 0a 74 68 65 20 66 69 6c 65 20 74 63 6c 72 65  n.the file tclre
13b0: 61 64 6c 69 6e 65 53 65 74 75 70 2e 74 63 6c 2e  adlineSetup.tcl.
13c0: 0a 0a 2e 54 50 20 35 0a 5c 66 42 3a 3a 74 63 6c  ...TP 5.\fB::tcl
13d0: 72 65 61 64 6c 69 6e 65 3a 3a 72 65 61 64 6c 69  readline::readli
13e0: 6e 65 20 62 75 69 6c 74 69 6e 63 6f 6d 70 6c 65  ne builtincomple
13f0: 74 65 72 5c 66 50 20 5b 5c 66 49 62 6f 6f 6c 5c  ter\fP [\fIbool\
1400: 66 50 5d 0a 65 6e 61 62 6c 65 20 6f 72 20 64 69  fP].enable or di
1410: 73 61 62 6c 65 20 74 68 65 20 62 75 69 6c 74 69  sable the builti
1420: 6e 20 63 6f 6d 70 6c 65 74 65 72 2e 20 49 66 20  n completer. If 
1430: 74 68 65 20 62 75 69 6c 74 69 6e 20 63 6f 6d 70  the builtin comp
1440: 6c 65 74 65 72 0a 69 73 20 65 6e 61 62 6c 65 64  leter.is enabled
1450: 2c 20 69 74 20 77 69 6c 6c 20 62 65 20 69 6e 76  , it will be inv
1460: 6f 6b 65 64 20 65 69 74 68 65 72 20 69 66 20 74  oked either if t
1470: 68 65 72 65 20 69 73 20 6e 6f 20 63 75 73 74 6f  here is no custo
1480: 6d 20 63 6f 6d 70 6c 65 74 65 72 2c 0a 6f 72 20  m completer,.or 
1490: 74 68 65 20 63 75 73 74 6f 6d 20 63 6f 6d 70 6c  the custom compl
14a0: 65 74 65 72 20 72 65 74 75 72 6e 65 64 20 61 6e  eter returned an
14b0: 20 65 6d 70 74 79 20 20 73 74 72 69 6e 67 2e 20   empty  string. 
14c0: 54 68 65 20 62 75 69 6c 74 69 6e 0a 63 6f 6d 70  The builtin.comp
14d0: 6c 65 74 65 72 20 69 73 20 6f 6e 20 62 79 20 64  leter is on by d
14e0: 65 66 61 75 6c 74 2e 0a 5c 66 42 74 63 6c 72 65  efault..\fBtclre
14f0: 61 64 6c 69 6e 65 3a 3a 72 65 61 64 6c 69 6e 65  adline::readline
1500: 20 62 75 69 6c 74 69 6e 63 6f 6d 70 6c 65 74 65   builtincomplete
1510: 72 5c 66 50 20 72 65 74 75 72 6e 73 20 74 68 65  r\fP returns the
1520: 20 63 75 72 72 65 6e 74 0a 63 75 73 74 6f 6d 20   current.custom 
1530: 63 6f 6d 70 6c 65 74 65 72 20 28 61 6c 73 6f 2c  completer (also,
1540: 20 69 66 20 63 61 6c 6c 65 64 20 77 2f 6f 20 74   if called w/o t
1550: 68 65 20 5c 66 49 62 6f 6f 6c 5c 66 50 20 61 72  he \fIbool\fP ar
1560: 67 75 6d 65 6e 74 29 2e 0a 0a 2e 54 50 20 35 0a  gument)....TP 5.
1570: 5c 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65  \fB::tclreadline
1580: 3a 3a 72 65 61 64 6c 69 6e 65 20 65 6f 66 63 68  ::readline eofch
1590: 61 72 5c 66 50 20 5b 5c 66 49 73 63 72 69 70 74  ar\fP [\fIscript
15a0: 5c 66 50 5d 0a 73 65 74 20 61 20 73 63 72 69 70  \fP].set a scrip
15b0: 74 20 77 68 69 63 68 20 77 69 6c 6c 20 62 65 20  t which will be 
15c0: 63 61 6c 6c 65 64 2c 20 69 66 20 72 65 61 64 6c  called, if readl
15d0: 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68 65 20  ine returns the 
15e0: 65 6f 66 20 63 68 61 72 61 63 74 65 72 0a 28 74  eof character.(t
15f0: 68 69 73 20 69 73 20 74 79 70 69 63 61 6c 6c 79  his is typically
1600: 20 74 68 65 20 63 61 73 65 20 69 66 20 43 54 52   the case if CTR
1610: 4c 2d 44 20 69 73 20 65 6e 74 65 72 65 64 20 61  L-D is entered a
1620: 74 20 74 68 65 20 76 65 72 79 20 62 65 67 69 6e  t the very begin
1630: 6e 69 6e 67 0a 6f 66 20 74 68 65 20 6c 69 6e 65  ning.of the line
1640: 29 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 66  ). The default f
1650: 6f 72 20 74 68 69 73 20 73 63 72 69 70 74 20 69  or this script i
1660: 73 20 22 70 75 74 73 20 7b 7d 3b 20 65 78 69 74  s "puts {}; exit
1670: 22 2e 20 53 65 74 74 69 6e 67 0a 74 68 69 73 20  ". Setting.this 
1680: 74 6f 20 61 6e 20 65 6d 70 74 79 20 76 61 6c 75  to an empty valu
1690: 65 20 64 69 73 61 62 6c 65 73 20 61 6e 79 20 61  e disables any a
16a0: 63 74 69 6f 6e 20 6f 6e 20 65 6f 66 2e 0a 5c 66  ction on eof..\f
16b0: 42 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 72 65  Btclreadline::re
16c0: 61 64 6c 69 6e 65 20 65 6f 66 5c 66 50 20 72 65  adline eof\fP re
16d0: 74 75 72 6e 73 20 74 68 65 20 63 75 72 72 65 6e  turns the curren
16e0: 74 20 65 6f 66 20 73 63 72 69 70 74 2e 0a 0a 2e  t eof script....
16f0: 54 50 20 35 0a 5c 66 42 3a 3a 74 63 6c 72 65 61  TP 5.\fB::tclrea
1700: 64 6c 69 6e 65 3a 3a 72 65 61 64 6c 69 6e 65 20  dline::readline 
1710: 69 6e 69 74 69 61 6c 69 7a 65 5c 66 50 20 5c 66  initialize\fP \f
1720: 49 68 69 73 74 6f 72 79 66 69 6c 65 5c 66 50 0a  Ihistoryfile\fP.
1730: 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 74  initialize the t
1740: 63 6c 72 65 61 64 6c 69 6e 65 20 69 6e 74 65 72  clreadline inter
1750: 66 61 63 65 20 61 6e 64 20 72 65 61 64 20 74 68  face and read th
1760: 65 20 68 69 73 74 6f 72 79 20 66 72 6f 6d 0a 74  e history from.t
1770: 68 65 20 5c 66 49 68 69 73 74 6f 72 79 66 69 6c  he \fIhistoryfil
1780: 65 5c 66 50 2e 20 4f 6e 20 73 75 63 63 65 73 20  e\fP. On succes 
1790: 61 6e 20 65 6d 70 74 79 20 73 74 72 69 6e 67 20  an empty string 
17a0: 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 54 68 69  is returned..Thi
17b0: 73 20 63 6f 6d 6d 61 6e 64 20 68 61 73 20 74 6f  s command has to
17c0: 20 62 65 20 63 61 6c 6c 65 64 20 62 65 66 6f 72   be called befor
17d0: 65 20 61 6e 79 20 6f 74 68 65 72 20 74 63 6c 72  e any other tclr
17e0: 65 61 64 6c 69 6e 65 20 63 6f 6d 6d 61 6e 64 73  eadline commands
17f0: 2e 0a 0a 2e 54 50 20 35 0a 5c 66 42 3a 3a 74 63  ....TP 5.\fB::tc
1800: 6c 72 65 61 64 6c 69 6e 65 3a 3a 72 65 61 64 6c  lreadline::readl
1810: 69 6e 65 20 72 65 61 64 5c 66 50 20 5c 66 49 70  ine read\fP \fIp
1820: 72 6f 6d 70 74 5c 66 50 0a 70 72 69 6e 74 73 20  rompt\fP.prints 
1830: 74 68 65 20 5c 66 49 70 72 6f 6d 70 74 5c 66 50  the \fIprompt\fP
1840: 20 74 6f 20 73 74 64 6f 75 74 20 61 6e 64 20 65   to stdout and e
1850: 6e 74 65 72 73 20 74 68 65 20 74 63 6c 72 65 61  nters the tclrea
1860: 64 6c 69 6e 65 20 65 76 65 6e 74 0a 6c 6f 6f 70  dline event.loop
1870: 2e 20 42 6f 74 68 20 72 65 61 64 6c 69 6e 65 20  . Both readline 
1880: 61 6e 64 20 58 20 65 76 65 6e 74 73 20 61 72 65  and X events are
1890: 20 70 72 6f 63 65 73 73 65 64 2e 20 52 65 74 75   processed. Retu
18a0: 72 6e 73 20 74 68 65 0a 28 65 76 65 6e 74 75 61  rns the.(eventua
18b0: 6c 6c 79 20 68 69 73 74 6f 72 79 2d 65 78 70 61  lly history-expa
18c0: 6e 64 65 64 29 20 69 6e 70 75 74 20 73 74 72 69  nded) input stri
18d0: 6e 67 2e 0a 0a 2e 54 50 20 35 0a 5c 66 42 3a 3a  ng....TP 5.\fB::
18e0: 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 72 65 61  tclreadline::rea
18f0: 64 6c 69 6e 65 20 77 72 69 74 65 5c 66 50 20 5c  dline write\fP \
1900: 66 49 68 69 73 74 6f 72 79 66 69 6c 65 5c 66 50  fIhistoryfile\fP
1910: 0a 77 72 69 74 65 73 20 74 68 65 20 68 69 73 74  .writes the hist
1920: 6f 72 79 20 74 6f 20 74 68 65 20 5c 66 49 68 69  ory to the \fIhi
1930: 73 74 6f 72 79 66 69 6c 65 5c 66 50 2e 20 54 68  storyfile\fP. Th
1940: 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 63 61  is command is ca
1950: 6c 6c 65 64 0a 61 75 74 6f 6d 61 74 69 63 61 6c  lled.automatical
1960: 6c 79 20 66 72 6f 6d 20 74 68 65 20 69 6e 74 65  ly from the inte
1970: 72 6e 61 6c 20 72 6f 75 74 69 6e 65 20 3a 3a 74  rnal routine ::t
1980: 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 45 78 69 74  clreadline::Exit
1990: 2e 0a 0a 2e 54 50 20 35 0a 5c 66 42 3a 3a 74 63  ....TP 5.\fB::tc
19a0: 6c 72 65 61 64 6c 69 6e 65 3a 3a 50 72 69 6e 74  lreadline::Print
19b0: 5c 66 50 20 5b 5c 66 49 79 65 73 20 2f 20 6e 6f  \fP [\fIyes / no
19c0: 5c 66 50 5d 0a 74 75 72 6e 73 20 6f 6e 20 6f 72  \fP].turns on or
19d0: 20 6f 66 66 20 74 68 65 20 64 65 66 61 75 6c 74   off the default
19e0: 20 62 65 68 61 76 69 6f 72 20 6f 66 20 74 63 6c   behavior of tcl
19f0: 73 68 20 74 6f 20 70 72 69 6e 74 20 74 68 65 20  sh to print the 
1a00: 72 65 73 75 6c 74 20 6f 66 0a 65 76 65 72 79 20  result of.every 
1a10: 63 6f 6d 6d 61 6e 64 2e 20 54 68 69 73 20 69 73  command. This is
1a20: 20 74 75 72 6e 65 64 20 6f 6e 20 62 79 20 64 65   turned on by de
1a30: 66 61 75 6c 74 2c 20 73 6f 20 69 74 20 77 69 6c  fault, so it wil
1a40: 6c 20 6a 75 73 74 20 62 65 68 61 76 65 0a 61 73  l just behave.as
1a50: 20 74 68 65 20 74 63 6c 73 68 20 77 2f 6f 20 74   the tclsh w/o t
1a60: 63 6c 72 65 61 64 6c 69 6e 65 2e 20 54 75 72 6e  clreadline. Turn
1a70: 69 6e 67 20 6f 66 66 20 6d 69 67 68 74 20 62 65  ing off might be
1a80: 20 75 73 65 66 75 6c 2c 20 77 68 65 6e 20 72 65   useful, when re
1a90: 61 64 69 6e 67 0a 62 69 6e 61 72 79 20 64 61 74  ading.binary dat
1aa0: 61 20 66 6f 72 20 65 78 61 6d 70 6c 65 2e 20 49  a for example. I
1ab0: 66 20 5c 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69  f \fB::tclreadli
1ac0: 6e 65 3a 3a 50 72 69 6e 74 5c 66 50 20 69 73 20  ne::Print\fP is 
1ad0: 63 61 6c 6c 65 64 20 77 2f 6f 0a 61 72 67 75 6d  called w/o.argum
1ae0: 65 6e 74 73 2c 20 69 74 20 72 65 74 75 72 6e 73  ents, it returns
1af0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 65 74   the current set
1b00: 74 69 6e 67 2e 0a 0a 2e 54 50 20 35 0a 5c 66 42  ting....TP 5.\fB
1b10: 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 4c  ::tclreadline::L
1b20: 6f 6f 70 5c 66 50 0a 65 6e 74 65 72 20 74 68 65  oop\fP.enter the
1b30: 20 74 63 6c 72 65 61 64 6c 69 6e 65 20 6d 61 69   tclreadline mai
1b40: 6e 20 6c 6f 6f 70 2e 20 54 68 69 73 20 63 6f 6d  n loop. This com
1b50: 6d 61 6e 64 20 69 73 20 74 79 70 69 63 61 6c 6c  mand is typicall
1b60: 79 20 63 61 6c 6c 65 64 20 66 72 6f 6d 0a 74 68  y called from.th
1b70: 65 20 73 74 61 72 74 75 70 20 72 65 73 6f 75 72  e startup resour
1b80: 63 65 20 66 69 6c 65 20 28 73 6f 6d 65 74 68 69  ce file (somethi
1b90: 6e 67 20 2e 74 63 6c 73 68 72 63 2c 20 64 65 70  ng .tclshrc, dep
1ba0: 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 69 6e  ending on the in
1bb0: 74 65 72 70 72 65 74 65 72 0a 79 6f 75 20 75 73  terpreter.you us
1bc0: 65 2c 20 73 65 65 20 74 68 65 20 66 69 6c 65 20  e, see the file 
1bd0: 60 73 61 6d 70 6c 65 2e 74 63 6c 73 68 72 63 27  `sample.tclshrc'
1be0: 29 2e 20 54 68 65 20 6d 61 69 6e 20 6c 6f 6f 70  ). The main loop
1bf0: 20 73 65 74 73 20 75 70 20 73 6f 6d 65 0a 63 6f   sets up some.co
1c00: 6d 70 6c 65 74 69 6f 6e 20 63 68 61 72 61 63 74  mpletion charact
1c10: 65 72 69 73 74 69 63 73 20 61 73 20 76 61 72 69  eristics as vari
1c20: 61 62 6c 65 20 2d 2d 20 74 72 79 20 73 6f 6d 65  able -- try some
1c30: 74 68 69 6e 67 20 6c 69 6b 65 20 22 70 75 74 73  thing like "puts
1c40: 20 24 62 3c 54 41 42 3e 22 20 2d 2d 20 0a 61 6e   $b<TAB>" -- .an
1c50: 64 20 63 6f 6d 6d 61 6e 64 20 63 6f 6d 70 6c 65  d command comple
1c60: 74 69 6f 6e 20 2d 2d 20 74 72 79 20 22 70 75 74  tion -- try "put
1c70: 73 20 5b 69 6e 3c 54 41 42 3e 22 2e 0a 5c 66 42  s [in<TAB>"..\fB
1c80: 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 4c  ::tclreadline::L
1c90: 6f 6f 70 5c 66 50 20 77 69 6c 6c 20 6e 6f 72 6d  oop\fP will norm
1ca0: 61 6c 6c 79 20 6e 6f 74 20 72 65 74 75 72 6e 2e  ally not return.
1cb0: 20 0a 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f   .If you want to
1cc0: 20 77 72 69 74 65 20 79 6f 75 72 20 6f 77 6e 20   write your own 
1cd0: 6d 61 69 6e 20 6c 6f 6f 70 20 61 6e 64 2f 6f 72  main loop and/or
1ce0: 20 6f 77 6e 20 63 75 73 74 6f 6d 20 63 6f 6d 70   own custom comp
1cf0: 6c 65 74 65 72 73 2c 0a 69 74 20 69 73 20 70 72  leters,.it is pr
1d00: 6f 62 61 62 6c 79 20 61 20 67 6f 6f 64 20 69 64  obably a good id
1d10: 65 61 20 74 6f 20 73 74 61 72 74 20 77 69 74 68  ea to start with
1d20: 20 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 4c 6f   tclreadline::Lo
1d30: 6f 70 0a 28 73 65 65 20 74 68 65 20 66 69 6c 65  op.(see the file
1d40: 20 74 63 6c 72 65 61 64 6c 69 6e 65 53 65 74 75   tclreadlineSetu
1d50: 70 2e 74 63 6c 29 2e 0a 0a 2e 54 50 20 35 0a 5c  p.tcl)....TP 5.\
1d60: 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a  fB::tclreadline:
1d70: 3a 70 72 6f 6d 70 74 31 5c 66 50 0a 61 20 70 72  :prompt1\fP.a pr
1d80: 6f 63 20 77 68 69 63 68 20 69 73 20 63 61 6c 6c  oc which is call
1d90: 65 64 20 62 79 20 3a 3a 74 63 6c 72 65 61 64 6c  ed by ::tclreadl
1da0: 69 6e 65 3a 3a 4c 6f 6f 70 20 61 6e 64 20 72 65  ine::Loop and re
1db0: 74 75 72 6e 73 20 61 20 73 74 72 69 6e 67 0a 77  turns a string.w
1dc0: 68 69 63 68 20 77 69 6c 6c 20 62 65 20 64 69 73  hich will be dis
1dd0: 70 6c 61 79 65 64 20 61 73 20 74 68 65 20 70 72  played as the pr
1de0: 69 6d 61 72 79 20 70 72 6f 6d 70 74 2e 20 54 68  imary prompt. Th
1df0: 69 73 20 70 72 6f 6d 70 74 20 77 69 6c 6c 20 62  is prompt will b
1e00: 65 0a 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65  e.something like
1e10: 20 22 5b 69 6e 66 6f 20 6e 61 6d 65 6f 66 65 78   "[info nameofex
1e20: 65 63 75 74 61 62 6c 65 5d 20 5c 5b 5b 70 77 64  ecutable] \[[pwd
1e30: 5d 5c 5d 22 20 70 6f 73 73 69 62 6c 79 20 66 61  ]\]" possibly fa
1e40: 6e 63 79 20 63 6f 6c 6f 72 65 64 2e 0a 54 68 65  ncy colored..The
1e50: 20 64 65 66 61 75 6c 74 20 70 72 6f 63 20 69 73   default proc is
1e60: 20 64 65 66 69 6e 65 64 20 6f 6e 20 65 6e 74 65   defined on ente
1e70: 72 69 6e 67 20 74 68 65 20 3a 3a 74 63 6c 72 65  ring the ::tclre
1e80: 61 64 6c 69 6e 65 3a 3a 4c 6f 6f 70 2c 0a 69 66  adline::Loop,.if
1e90: 20 69 74 20 69 73 20 6e 6f 74 20 61 6c 72 65 61   it is not alrea
1ea0: 64 79 20 64 65 66 69 6e 65 64 2e 20 53 6f 3a 20  dy defined. So: 
1eb0: 49 66 20 79 6f 75 20 64 65 66 69 6e 65 20 79 6f  If you define yo
1ec0: 75 72 20 6f 77 6e 20 70 72 6f 63 0a 3a 3a 74 63  ur own proc.::tc
1ed0: 6c 72 65 61 64 6c 69 6e 65 3a 3a 70 72 6f 6d 70  lreadline::promp
1ee0: 74 31 20 62 65 66 6f 72 65 20 65 6e 74 65 72 69  t1 before enteri
1ef0: 6e 67 20 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65  ng ::tclreadline
1f00: 3a 3a 4c 6f 6f 70 2c 20 74 68 69 73 0a 70 72 6f  ::Loop, this.pro
1f10: 63 20 69 73 20 63 61 6c 6c 65 64 20 65 61 63 68  c is called each
1f20: 20 74 69 6d 65 20 74 68 65 20 70 72 6f 6d 70 74   time the prompt
1f30: 20 69 73 20 74 6f 20 62 65 20 64 69 73 70 6c 61   is to be displa
1f40: 79 65 64 2e 0a 45 78 61 6d 70 6c 65 3a 0a 2e 43  yed..Example:..C
1f50: 53 0a 20 20 20 20 70 61 63 6b 61 67 65 20 72 65  S.    package re
1f60: 71 75 69 72 65 20 74 63 6c 72 65 61 64 6c 69 6e  quire tclreadlin
1f70: 65 0a 20 20 20 20 6e 61 6d 65 73 70 61 63 65 20  e.    namespace 
1f80: 65 76 61 6c 20 74 63 6c 72 65 61 64 6c 69 6e 65  eval tclreadline
1f90: 20 7b 0a 20 20 20 20 20 20 20 20 70 72 6f 63 20   {.        proc 
1fa0: 70 72 6f 6d 70 74 31 20 7b 7d 20 7b 0a 20 20 20  prompt1 {} {.   
1fb0: 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20           return 
1fc0: 22 5b 63 6c 6f 63 6b 20 66 6f 72 6d 61 74 20 5b  "[clock format [
1fd0: 63 6c 6f 63 6b 20 73 65 63 6f 6e 64 73 5d 5d 3e  clock seconds]]>
1fe0: 20 22 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20   ".        }.   
1ff0: 20 7d 0a 20 20 20 20 3a 3a 74 63 6c 72 65 61 64   }.    ::tclread
2000: 6c 69 6e 65 3a 3a 4c 6f 6f 70 0a 2e 43 45 0a 0a  line::Loop..CE..
2010: 4e 6f 74 65 20 74 68 61 74 20 6e 6f 6e 2d 70 72  Note that non-pr
2020: 69 6e 74 61 62 6c 65 20 63 6f 6e 74 72 6f 6c 20  intable control 
2030: 63 68 61 72 61 63 74 65 72 73 20 61 73 20 63 6f  characters as co
2040: 6c 6f 72 20 63 6f 6e 74 72 6f 6c 20 63 68 61 72  lor control char
2050: 61 63 74 65 72 73 0a 6d 75 73 74 20 62 65 20 65  acters.must be e
2060: 6e 63 6c 6f 73 65 64 20 69 6e 20 6c 69 74 65 72  nclosed in liter
2070: 61 6c 20 63 74 72 6c 2d 61 20 2f 20 63 74 72 6c  al ctrl-a / ctrl
2080: 2d 62 20 74 6f 20 74 65 6c 6c 20 72 65 61 64 6c  -b to tell readl
2090: 69 6e 65 20 74 68 65 20 6c 65 6e 67 74 68 0a 6f  ine the length.o
20a0: 66 20 74 68 65 20 70 72 69 6e 74 61 62 6c 65 20  f the printable 
20b0: 70 72 6f 6d 70 74 2e 20 53 65 65 20 66 6f 72 20  prompt. See for 
20c0: 65 78 61 6d 70 6c 65 20 74 68 65 20 76 61 72 69  example the vari
20d0: 61 62 6c 65 20 60 70 72 6f 6d 70 74 5f 73 74 72  able `prompt_str
20e0: 69 6e 67 27 0a 69 6e 20 74 68 65 20 66 69 6c 65  ing'.in the file
20f0: 20 74 63 6c 72 65 61 64 6c 69 6e 65 53 65 74 75   tclreadlineSetu
2100: 70 2e 74 63 6c 20 69 6e 20 79 6f 75 72 20 74 63  p.tcl in your tc
2110: 6c 72 65 61 64 6c 69 6e 65 20 69 6e 73 74 61 6c  lreadline instal
2120: 6c 61 74 69 6f 6e 20 64 69 72 65 63 74 6f 72 79  lation directory
2130: 2e 0a 0a 0a 2e 5c 22 20 2e 53 48 20 22 45 58 41  .....\" .SH "EXA
2140: 4d 50 4c 45 53 22 0a 0a 0a 2e 5c 22 20 2e 53 48  MPLES"....\" .SH
2150: 20 22 45 4e 56 49 52 4f 4e 4d 45 4e 54 20 56 41   "ENVIRONMENT VA
2160: 52 49 41 42 4c 45 53 22 0a 0a 2e 53 48 20 22 56  RIABLES"...SH "V
2170: 41 52 49 41 42 4c 45 53 22 0a 0a 54 68 65 20 67  ARIABLES"..The g
2180: 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 5c  lobal variable \
2190: 66 42 74 63 6c 72 65 61 64 6c 69 6e 65 5f 76 65  fBtclreadline_ve
21a0: 72 73 69 6f 6e 5c 66 50 20 68 6f 6c 64 73 20 74  rsion\fP holds t
21b0: 68 65 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65  he version numbe
21c0: 72 0a 6f 66 20 74 68 65 20 74 63 6c 72 65 61 64  r.of the tclread
21d0: 6c 69 6e 65 20 70 61 63 6b 61 67 65 2e 0a 0a 2e  line package....
21e0: 53 48 20 22 46 49 4c 45 53 22 0a 0a 74 68 65 20  SH "FILES"..the 
21f0: 5c 66 42 2e 74 63 6c 73 68 72 63 5c 66 50 20 66  \fB.tclshrc\fP f
2200: 69 6c 65 20 69 6e 20 74 68 65 20 48 4f 4d 45 20  ile in the HOME 
2210: 64 69 72 65 63 74 6f 72 79 2c 20 77 68 69 63 68  directory, which
2220: 0a 69 73 20 72 65 61 64 20 6f 6e 20 74 63 6c 73  .is read on tcls
2230: 68 20 73 74 61 72 74 75 70 2e 20 41 6c 74 65 72  h startup. Alter
2240: 6e 61 74 69 76 65 6c 79 2c 20 74 68 65 20 6e 61  natively, the na
2250: 6d 65 20 6f 66 20 74 68 69 73 20 69 6e 69 74 69  me of this initi
2260: 61 6c 69 7a 61 74 69 6f 6e 0a 66 69 6c 65 20 6d  alization.file m
2270: 69 67 68 74 20 62 65 20 5c 66 42 2e 77 69 73 68  ight be \fB.wish
2280: 72 63 5c 66 50 20 2e 2e 2e 20 64 65 70 65 6e 64  rc\fP ... depend
2290: 69 6e 67 20 6f 6e 20 77 68 61 74 20 69 6e 74 65  ing on what inte
22a0: 72 70 72 65 74 65 72 20 79 6f 75 20 75 73 65 2e  rpreter you use.
22b0: 0a 54 68 65 73 65 20 66 69 6c 65 73 20 73 68 6f  .These files sho
22c0: 75 6c 64 20 74 79 70 69 63 61 6c 6c 79 20 63 6f  uld typically co
22d0: 6e 74 61 69 6e 20 73 6f 6d 65 74 68 69 6e 67 20  ntain something 
22e0: 6c 69 6b 65 0a 2e 43 53 0a 20 20 20 20 69 66 20  like..CS.    if 
22f0: 7b 24 74 63 6c 5f 69 6e 74 65 72 61 63 74 69 76  {$tcl_interactiv
2300: 65 7d 20 7b 0a 20 20 20 20 20 20 20 20 70 61 63  e} {.        pac
2310: 6b 61 67 65 20 72 65 71 75 69 72 65 20 74 63 6c  kage require tcl
2320: 72 65 61 64 6c 69 6e 65 0a 20 20 20 20 20 20 20  readline.       
2330: 20 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a   ::tclreadline::
2340: 4c 6f 6f 70 0a 20 20 20 20 7d 0a 2e 43 45 0a 0a  Loop.    }..CE..
2350: 77 68 69 63 68 20 77 69 6c 6c 20 65 6e 74 65 72  which will enter
2360: 20 74 68 65 20 74 63 6c 72 65 61 64 6c 69 6e 65   the tclreadline
2370: 20 6d 61 69 6e 20 6c 6f 6f 70 2e 0a 0a 2e 50 50   main loop....PP
2380: 0a 74 68 65 20 5c 66 42 2e 74 63 6c 73 68 2d 68  .the \fB.tclsh-h
2390: 69 73 74 6f 72 79 5c 66 50 20 66 69 6c 65 20 69  istory\fP file i
23a0: 6e 20 74 68 65 20 48 4f 4d 45 20 64 69 72 65 63  n the HOME direc
23b0: 74 6f 72 79 2e 20 4f 6e 20 73 74 61 72 74 75 70  tory. On startup
23c0: 0a 63 6f 6d 6d 61 6e 64 73 20 77 69 6c 6c 20 62  .commands will b
23d0: 65 20 72 65 61 64 20 66 72 6f 6d 20 74 68 69 73  e read from this
23e0: 20 66 69 6c 65 2e 20 4f 6e 20 65 78 69 74 2c 20   file. On exit, 
23f0: 74 68 65 20 72 65 61 64 6c 69 6e 65 20 68 69 73  the readline his
2400: 74 6f 72 79 0a 69 73 20 77 72 69 74 74 65 6e 20  tory.is written 
2410: 74 6f 20 74 68 69 73 20 66 69 6c 65 2e 20 4e 6f  to this file. No
2420: 74 65 20 74 68 61 74 20 69 66 20 79 6f 75 20 61  te that if you a
2430: 62 6f 72 74 20 74 63 6c 73 68 20 77 69 74 68 20  bort tclsh with 
2440: 3c 63 6e 74 72 6c 2d 63 3e 0a 6e 6f 20 68 69 73  <cntrl-c>.no his
2450: 74 6f 72 79 20 69 73 20 77 72 69 74 74 65 6e 2e  tory is written.
2460: 20 46 6f 72 20 74 68 65 20 66 75 74 75 72 65 20   For the future 
2470: 69 74 20 69 73 20 70 6c 61 6e 6e 65 64 20 74 6f  it is planned to
2480: 20 73 65 74 20 75 70 20 61 20 73 69 67 6e 61 6c   set up a signal
2490: 0a 68 61 6e 64 6c 65 72 2c 20 77 68 69 63 68 20  .handler, which 
24a0: 77 69 6c 6c 20 77 72 69 74 65 20 74 68 65 20 68  will write the h
24b0: 69 73 74 6f 72 79 20 6f 6e 20 3c 63 74 72 6c 2d  istory on <ctrl-
24c0: 63 3e 20 62 65 66 6f 72 65 20 65 78 69 74 69 6e  c> before exitin
24d0: 67 2e 0a 0a 2e 50 50 0a 74 68 65 20 5c 66 42 2e  g....PP.the \fB.
24e0: 69 6e 70 75 74 72 63 5c 66 50 20 66 69 6c 65 20  inputrc\fP file 
24f0: 69 6e 20 74 68 65 20 75 73 65 72 73 20 48 4f 4d  in the users HOM
2500: 45 20 64 69 72 65 63 74 6f 72 79 2e 20 54 68 69  E directory. Thi
2510: 73 20 66 69 6c 65 0a 69 73 20 75 73 65 64 20 6e  s file.is used n
2520: 6f 72 6d 61 6c 6c 79 20 66 6f 72 20 61 6c 6c 20  ormally for all 
2530: 70 72 6f 67 72 61 6d 73 20 77 68 69 63 68 20 75  programs which u
2540: 73 65 20 74 68 65 20 67 6e 75 20 72 65 61 64 6c  se the gnu readl
2550: 69 6e 65 20 28 65 2e 67 2e 20 20 62 61 73 68 29  ine (e.g.  bash)
2560: 2e 0a 54 68 65 20 60 67 6c 6f 62 61 6c 27 20 72  ..The `global' r
2570: 65 61 64 6c 69 6e 65 20 73 65 74 74 69 6e 67 73  eadline settings
2580: 20 74 68 65 72 65 20 77 69 6c 6c 20 62 65 20 76   there will be v
2590: 61 6c 69 64 20 61 6c 73 6f 20 66 6f 72 0a 5c 66  alid also for.\f
25a0: 42 74 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50 2e  Btclreadline\fP.
25b0: 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 20 74 68   Additionally th
25c0: 65 20 2e 69 6e 70 75 74 72 63 20 6d 69 67 68 74  e .inputrc might
25d0: 20 68 6f 6c 64 20 63 6f 6e 64 69 74 69 6f 6e 61   hold conditiona
25e0: 6c 0a 73 65 74 74 69 6e 67 73 20 66 6f 72 20 74  l.settings for t
25f0: 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f  he implementatio
2600: 6e 20 6e 61 6d 65 20 5c 66 42 74 63 6c 72 65 61  n name \fBtclrea
2610: 64 6c 69 6e 65 5c 66 50 2e 20 45 78 61 6d 70 6c  dline\fP. Exampl
2620: 65 20 6f 66 20 0a 73 6f 6d 65 20 6c 69 6e 65 73  e of .some lines
2630: 20 69 6e 20 79 6f 75 72 20 2e 69 6e 70 75 74 72   in your .inputr
2640: 63 3a 0a 2e 43 53 0a 20 20 20 20 24 69 66 20 74  c:..CS.    $if t
2650: 63 6c 72 65 61 64 6c 69 6e 65 0a 20 20 20 20 22  clreadline.    "
2660: 5c 5c 43 2d 78 70 22 3a 20 22 70 75 74 73 20 24  \\C-xp": "puts $
2670: 65 6e 76 28 50 41 54 48 29 22 0a 20 20 20 20 24  env(PATH)".    $
2680: 65 6e 64 69 66 0a 2e 43 45 0a 0a 46 6f 72 20 66  endif..CE..For f
2690: 75 72 74 68 65 72 20 64 6f 63 75 6d 65 6e 74 61  urther documenta
26a0: 74 69 6f 6e 20 70 6c 65 61 73 65 20 72 65 66 65  tion please refe
26b0: 72 20 74 6f 20 74 68 65 20 67 6e 75 20 72 65 61  r to the gnu rea
26c0: 64 6c 69 6e 65 20 64 6f 63 75 6d 65 6e 74 61 74  dline documentat
26d0: 69 6f 6e 2e 0a 0a 2e 53 48 20 22 42 55 47 53 22  ion....SH "BUGS"
26e0: 0a 70 72 6f 62 61 62 6c 79 2e 0a 0a 0a 2e 53 48  .probably.....SH
26f0: 20 22 53 45 45 20 41 4c 53 4f 22 0a 0a 0a 2e 50   "SEE ALSO"....P
2700: 50 0a 54 68 65 20 6f 66 66 69 63 69 61 6c 20 5c  P.The official \
2710: 66 42 74 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50  fBtclreadline\fP
2720: 20 77 65 62 20 73 69 74 65 20 61 74 3a 0a 0a 2e   web site at:...
2730: 50 50 0a 2e 52 53 20 34 0a 68 74 74 70 3a 2f 2f  PP..RS 4.http://
2740: 77 77 77 2e 7a 65 6c 6c 6e 65 72 2e 6f 72 67 2f  www.zellner.org/
2750: 74 63 6c 72 65 61 64 6c 69 6e 65 2f 0a 2e 52 45  tclreadline/..RE
2760: 0a 0a 0a 2e 53 48 20 22 41 55 54 48 4f 52 22 0a  ....SH "AUTHOR".
2770: 4a 6f 68 61 6e 6e 65 73 20 5a 65 6c 6c 6e 65 72  Johannes Zellner
2780: 2c 20 3c 6a 6f 68 61 6e 6e 65 73 40 7a 65 6c 6c  , <johannes@zell
2790: 6e 65 72 2e 6f 72 67 3e 0a 0a 2e 53 48 20 22 43  ner.org>...SH "C
27a0: 4f 4e 54 52 49 42 55 54 49 4f 4e 53 2c 20 53 55  ONTRIBUTIONS, SU
27b0: 47 47 45 53 54 49 4f 4e 53 20 41 4e 44 20 50 41  GGESTIONS AND PA
27c0: 54 43 48 45 53 22 0a 4d 61 67 6e 75 73 20 45 72  TCHES".Magnus Er
27d0: 69 6b 73 73 6f 6e 20 3c 6d 61 67 6e 75 73 2e 65  iksson <magnus.e
27e0: 72 69 6b 73 73 6f 6e 40 6e 65 74 69 6e 73 69 67  riksson@netinsig
27f0: 68 74 2e 73 65 3e 2c 0a 4c 65 73 20 4a 6f 68 6e  ht.se>,.Les John
2800: 73 6f 6e 20 3c 6c 65 73 40 69 6e 66 6f 6c 61 62  son <les@infolab
2810: 73 2e 63 6f 6d 3e 2c 0a 48 61 72 61 6c 64 20 4b  s.com>,.Harald K
2820: 69 72 73 63 68 20 3c 6b 69 72 40 69 69 74 62 2e  irsch <kir@iitb.
2830: 66 68 67 2e 64 65 3e 2c 0a 43 68 72 69 73 74 69  fhg.de>,.Christi
2840: 61 6e 20 4b 72 6f 6e 65 20 3c 6b 72 69 73 63 68  an Krone <krisch
2850: 61 6e 40 73 71 6c 2e 64 65 3e 2c 0a 4c 61 72 72  an@sql.de>,.Larr
2860: 79 20 57 2e 20 56 69 72 64 65 6e 20 3c 6c 76 69  y W. Virden <lvi
2870: 72 64 65 6e 40 63 61 73 2e 6f 72 67 3e 2c 0a 44  rden@cas.org>,.D
2880: 61 76 69 64 20 45 6e 67 65 6c 20 3c 64 6c 65 6e  avid Engel <dlen
2890: 67 65 6c 40 68 6f 6d 65 2e 63 6f 6d 3e 2c 20 3c  gel@home.com>, <
28a0: 64 61 76 69 64 40 64 65 62 69 61 6e 2e 6f 72 67  david@debian.org
28b0: 3e 0a 0a 2e 53 48 20 22 44 45 42 49 41 4e 20 50  >...SH "DEBIAN P
28c0: 41 43 4b 41 47 45 22 0a 44 61 76 69 64 20 45 6e  ACKAGE".David En
28d0: 67 65 6c 20 3c 64 6c 65 6e 67 65 6c 40 68 6f 6d  gel <dlengel@hom
28e0: 65 2e 63 6f 6d 3e 2c 20 3c 64 61 76 69 64 40 64  e.com>, <david@d
28f0: 65 62 69 61 6e 2e 6f 72 67 3e 0a 0a 2e 53 48 20  ebian.org>...SH 
2900: 22 44 49 53 43 4c 41 49 4d 45 52 22 0a 0a 54 68  "DISCLAIMER"..Th
2910: 69 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 5c 66  is version of \f
2920: 42 74 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50 20  Btclreadline\fP 
2930: 69 73 20 73 74 69 6c 6c 20 61 20 64 65 76 65 6c  is still a devel
2940: 6f 70 6d 65 6e 74 20 76 65 72 73 69 6f 6e 2e 0a  opment version..
2950: 50 72 65 74 74 79 20 61 20 6c 6f 74 20 6f 66 20  Pretty a lot of 
2960: 66 65 61 74 75 72 65 73 20 61 6e 64 20 69 64 65  features and ide
2970: 61 73 20 61 72 65 20 6e 6f 74 20 69 6d 70 6c 65  as are not imple
2980: 6d 65 6e 74 65 64 20 79 65 74 2e 20 54 68 65 0a  mented yet. The.
2990: 72 65 61 73 6f 6e 20 66 6f 72 20 74 68 69 73 20  reason for this 
29a0: 69 73 20 74 68 65 20 6c 61 63 6b 20 6f 66 20 74  is the lack of t
29b0: 69 6d 65 20 61 6e 64 20 6d 61 6e 70 6f 77 65 72  ime and manpower
29c0: 2e 0a 53 6f 20 79 6f 75 20 61 72 65 20 77 65 6c  ..So you are wel
29d0: 63 6f 6d 65 20 74 6f 20 6d 6f 64 69 66 79 20 61  come to modify a
29e0: 6e 64 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f  nd contribute to
29f0: 20 74 68 65 20 63 6f 64 65 2e 0a 49 66 20 79 6f   the code..If yo
2a00: 75 20 68 61 76 65 20 73 75 67 67 65 73 74 69 6f  u have suggestio
2a10: 6e 73 2c 20 70 6c 65 61 73 65 20 6c 65 74 20 6d  ns, please let m
2a20: 65 20 6b 6e 6f 77 2e 0a 0a 5c 66 42 74 63 6c 72  e know...\fBtclr
2a30: 65 61 64 6c 69 6e 65 5c 66 50 20 63 6f 6d 65 73  eadline\fP comes
2a40: 20 77 69 74 68 20 74 68 65 20 47 50 4c 20 28 47   with the GPL (G
2a50: 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69  NU General Publi
2a60: 63 20 4c 69 63 65 6e 73 65 29 2e 0a 59 6f 75 20  c License)..You 
2a70: 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65 63 65  should have rece
2a80: 69 76 65 64 20 61 20 63 6f 70 79 20 6f 66 20 74  ived a copy of t
2a90: 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50  he GNU General P
2aa0: 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 0a 61 6c  ublic License.al
2ab0: 6f 6e 67 20 77 69 74 68 20 74 68 69 73 20 70 72  ong with this pr
2ac0: 6f 67 72 61 6d 3b 20 69 66 20 6e 6f 74 2c 20 77  ogram; if not, w
2ad0: 72 69 74 65 20 74 6f 20 74 68 65 20 46 72 65 65  rite to the Free
2ae0: 20 53 6f 66 74 77 61 72 65 0a 46 6f 75 6e 64 61   Software.Founda
2af0: 74 69 6f 6e 2c 20 49 6e 63 2e 2c 20 35 39 20 54  tion, Inc., 59 T
2b00: 65 6d 70 6c 65 20 50 6c 61 63 65 20 2d 20 53 75  emple Place - Su
2b10: 69 74 65 20 33 33 30 2c 20 42 6f 73 74 6f 6e 2c  ite 330, Boston,
2b20: 20 4d 41 20 20 30 32 31 31 31 2d 31 33 30 37 2c   MA  02111-1307,
2b30: 20 55 53 41 2e 0a                                 USA..