Hex Artifact Content
Not logged in

Artifact 9557ae4fe67a3ae5793b4aee3ded5530aaf428a4:


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 46 49 4c 45 3a 20 22 2f 68 6f 6d 65 2f 6a  " FILE: "/home/j
0050: 6f 7a 65 2f 73 72 63 2f 74 63 6c 72 65 61 64 6c  oze/src/tclreadl
0060: 69 6e 65 2f 74 63 6c 72 65 61 64 6c 69 6e 65 2e  ine/tclreadline.
0070: 6e 2e 69 6e 22 0a 2e 5c 22 20 4c 41 53 54 20 4d  n.in"..\" LAST M
0080: 4f 44 49 46 49 45 44 3a 20 22 4d 6f 6e 20 4d 61  ODIFIED: "Mon Ma
0090: 72 20 20 31 20 31 33 3a 33 38 3a 31 35 20 31 39  r  1 13:38:15 19
00a0: 39 39 20 28 6a 6f 7a 65 29 22 0a 2e 5c 22 20 28  99 (joze)"..\" (
00b0: 43 29 20 31 39 39 39 20 62 79 20 4a 6f 68 61 6e  C) 1999 by Johan
00c0: 6e 65 73 20 5a 65 6c 6c 6e 65 72 0a 2e 5c 22 20  nes Zellner..\" 
00d0: 4a 6f 68 61 6e 6e 65 73 2e 5a 65 6c 6c 6e 65 72  Johannes.Zellner
00e0: 40 70 68 79 73 69 6b 2e 75 6e 69 2d 6b 61 72 6c  @physik.uni-karl
00f0: 73 72 75 68 65 2e 64 65 0a 2e 5c 22 20 24 49 64  sruhe.de..\" $Id
0100: 24 0a 2e 5c 22 20 2d 2d 2d 0a 2e 5c 22 0a 2e 5c  $..\" ---..\"..\
0110: 22 20 74 63 6c 72 65 61 64 6c 69 6e 65 20 2d 2d  " tclreadline --
0120: 20 67 6e 75 20 72 65 61 64 6c 69 6e 65 20 66 6f   gnu readline fo
0130: 72 20 74 68 65 20 74 63 6c 20 73 63 72 69 70 74  r the tcl script
0140: 69 6e 67 20 6c 61 6e 67 75 61 67 65 0a 2e 5c 22  ing language..\"
0150: 20 43 6f 70 79 72 69 67 68 74 20 28 43 29 20 31   Copyright (C) 1
0160: 39 39 39 20 20 4a 6f 68 61 6e 6e 65 73 20 5a 65  999  Johannes Ze
0170: 6c 6c 6e 65 72 0a 2e 5c 22 0a 2e 5c 22 20 54 68  llner..\"..\" Th
0180: 69 73 20 70 72 6f 67 72 61 6d 20 69 73 20 66 72  is program is fr
0190: 65 65 20 73 6f 66 74 77 61 72 65 3b 20 79 6f 75  ee software; you
01a0: 20 63 61 6e 20 72 65 64 69 73 74 72 69 62 75 74   can redistribut
01b0: 65 20 69 74 20 61 6e 64 2f 6f 72 0a 2e 5c 22 20  e it and/or..\" 
01c0: 6d 6f 64 69 66 79 20 69 74 20 75 6e 64 65 72 20  modify it under 
01d0: 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 65  the terms of the
01e0: 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62   GNU General Pub
01f0: 6c 69 63 20 4c 69 63 65 6e 73 65 0a 2e 5c 22 20  lic License..\" 
0200: 61 73 20 70 75 62 6c 69 73 68 65 64 20 62 79 20  as published by 
0210: 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72  the Free Softwar
0220: 65 20 46 6f 75 6e 64 61 74 69 6f 6e 3b 20 65 69  e Foundation; ei
0230: 74 68 65 72 20 76 65 72 73 69 6f 6e 20 32 0a 2e  ther version 2..
0240: 5c 22 20 6f 66 20 74 68 65 20 4c 69 63 65 6e 73  \" of the Licens
0250: 65 2c 20 6f 72 20 28 61 74 20 79 6f 75 72 20 6f  e, or (at your o
0260: 70 74 69 6f 6e 29 20 61 6e 79 20 6c 61 74 65 72  ption) any later
0270: 20 76 65 72 73 69 6f 6e 2e 0a 2e 5c 22 0a 2e 5c   version...\"..\
0280: 22 20 54 68 69 73 20 70 72 6f 67 72 61 6d 20 69  " This program i
0290: 73 20 64 69 73 74 72 69 62 75 74 65 64 20 69 6e  s distributed in
02a0: 20 74 68 65 20 68 6f 70 65 20 74 68 61 74 20 69   the hope that i
02b0: 74 20 77 69 6c 6c 20 62 65 20 75 73 65 66 75 6c  t will be useful
02c0: 2c 0a 2e 5c 22 20 62 75 74 20 57 49 54 48 4f 55  ,..\" but WITHOU
02d0: 54 20 41 4e 59 20 57 41 52 52 41 4e 54 59 3b 20  T ANY WARRANTY; 
02e0: 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 68 65  without even the
02f0: 20 69 6d 70 6c 69 65 64 20 77 61 72 72 61 6e 74   implied warrant
0300: 79 20 6f 66 0a 2e 5c 22 20 4d 45 52 43 48 41 4e  y of..\" MERCHAN
0310: 54 41 42 49 4c 49 54 59 20 6f 72 20 46 49 54 4e  TABILITY or FITN
0320: 45 53 53 20 46 4f 52 20 41 20 50 41 52 54 49 43  ESS FOR A PARTIC
0330: 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 53  ULAR PURPOSE.  S
0340: 65 65 20 74 68 65 0a 2e 5c 22 20 47 4e 55 20 47  ee the..\" GNU G
0350: 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69  eneral Public Li
0360: 63 65 6e 73 65 20 66 6f 72 20 6d 6f 72 65 20 64  cense for more d
0370: 65 74 61 69 6c 73 2e 0a 2e 5c 22 0a 2e 5c 22 20  etails...\"..\" 
0380: 59 6f 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20  You should have 
0390: 72 65 63 65 69 76 65 64 20 61 20 63 6f 70 79 20  received a copy 
03a0: 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72  of the GNU Gener
03b0: 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73  al Public Licens
03c0: 65 0a 2e 5c 22 20 61 6c 6f 6e 67 20 77 69 74 68  e..\" along with
03d0: 20 74 68 69 73 20 70 72 6f 67 72 61 6d 3b 20 69   this program; i
03e0: 66 20 6e 6f 74 2c 20 77 72 69 74 65 20 74 6f 20  f not, write to 
03f0: 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 72  the Free Softwar
0400: 65 0a 2e 5c 22 20 46 6f 75 6e 64 61 74 69 6f 6e  e..\" Foundation
0410: 2c 20 49 6e 63 2e 2c 20 35 39 20 54 65 6d 70 6c  , Inc., 59 Templ
0420: 65 20 50 6c 61 63 65 20 2d 20 53 75 69 74 65 20  e Place - Suite 
0430: 33 33 30 2c 20 42 6f 73 74 6f 6e 2c 20 4d 41 20  330, Boston, MA 
0440: 20 30 32 31 31 31 2d 31 33 30 37 2c 20 55 53 41   02111-1307, USA
0450: 2e 0a 2e 5c 22 0a 2e 5c 22 20 4a 6f 68 61 6e 6e  ...\"..\" Johann
0460: 65 73 2e 5a 65 6c 6c 6e 65 72 40 70 68 79 73 69  es.Zellner@physi
0470: 6b 2e 75 6e 69 2d 6b 61 72 6c 73 72 75 68 65 2e  k.uni-karlsruhe.
0480: 64 65 0a 2e 5c 22 20 68 74 74 70 3a 2f 2f 6b 72  de..\" http://kr
0490: 69 73 61 6c 2e 70 68 79 73 69 6b 2e 75 6e 69 2d  isal.physik.uni-
04a0: 6b 61 72 6c 73 72 75 68 65 2e 64 65 2f 7e 6a 6f  karlsruhe.de/~jo
04b0: 7a 65 0a 0a 0a 2e 53 48 20 4e 41 4d 45 0a 74 63  ze....SH NAME.tc
04c0: 6c 72 65 61 64 6c 69 6e 65 20 5c 2d 20 67 6e 75  lreadline \- gnu
04d0: 20 72 65 61 64 6c 69 6e 65 20 66 6f 72 20 74 68   readline for th
04e0: 65 20 74 63 6c 20 73 63 72 69 70 74 69 6e 67 20  e tcl scripting 
04f0: 6c 61 6e 67 75 61 67 65 0a 0a 0a 2e 53 48 20 53  language....SH S
0500: 59 4e 4f 50 53 49 53 0a 2e 54 50 20 36 0a 5c 66  YNOPSIS..TP 6.\f
0510: 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a  B::tclreadline::
0520: 72 65 61 64 6c 69 6e 65 5c 66 50 20 5c 66 49 63  readline\fP \fIc
0530: 6f 6d 6d 61 6e 64 5c 66 50 20 5b 5c 66 49 6f 70  ommand\fP [\fIop
0540: 74 69 6f 6e 73 5c 66 50 5d 0a 0a 0a 2e 53 48 20  tions\fP]....SH 
0550: 44 45 53 43 52 49 50 54 49 4f 4e 0a 0a 54 68 65  DESCRIPTION..The
0560: 20 5c 66 42 74 63 6c 72 65 61 64 6c 69 6e 65 5c   \fBtclreadline\
0570: 66 50 20 70 61 63 6b 61 67 65 20 6d 61 6b 65 73  fP package makes
0580: 20 74 68 65 20 67 6e 75 20 72 65 61 64 6c 69 6e   the gnu readlin
0590: 65 20 61 76 61 69 6c 61 62 6c 65 0a 74 6f 20 74  e available.to t
05a0: 68 65 20 73 63 72 69 70 74 69 6e 67 20 6c 61 6e  he scripting lan
05b0: 67 75 61 67 65 20 74 63 6c 2e 20 54 68 65 20 70  guage tcl. The p
05c0: 72 69 6d 61 72 79 20 70 75 72 70 6f 73 65 20 6f  rimary purpose o
05d0: 66 20 74 68 65 20 70 61 63 6b 61 67 65 0a 69 73  f the package.is
05e0: 20 74 6f 20 66 61 63 69 6c 69 74 61 74 65 20 74   to facilitate t
05f0: 68 65 20 69 6e 74 65 72 61 63 74 69 76 65 20 73  he interactive s
0600: 63 72 69 70 74 20 64 65 76 65 6c 6f 70 6d 65 6e  cript developmen
0610: 74 20 62 79 20 74 68 65 20 6d 65 61 6e 73 0a 6f  t by the means.o
0620: 66 20 77 6f 72 64 20 61 6e 64 20 66 69 6c 65 20  f word and file 
0630: 6e 61 6d 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 20  name completion 
0640: 61 73 20 77 65 6c 6c 20 61 73 20 68 69 73 74 6f  as well as histo
0650: 72 79 20 65 78 70 61 6e 73 69 6f 6e 0a 28 77 65  ry expansion.(we
0660: 6c 6c 20 6b 6e 6f 77 6e 20 66 72 6f 6d 20 73 68  ll known from sh
0670: 65 6c 6c 73 20 6c 69 6b 65 20 62 61 73 68 29 2e  ells like bash).
0680: 0a 0a 41 64 64 69 74 69 6f 6e 61 6c 6c 79 20 74  ..Additionally t
0690: 63 6c 72 65 61 64 6c 69 6e 65 20 63 61 6e 20 61  clreadline can a
06a0: 6c 73 6f 20 62 65 20 75 73 65 64 20 66 6f 72 20  lso be used for 
06b0: 74 63 6c 20 73 63 72 69 70 74 73 0a 77 68 69 63  tcl scripts.whic
06c0: 68 20 77 61 6e 74 20 74 6f 20 75 73 65 20 61 20  h want to use a 
06d0: 73 68 65 6c 6c 20 6c 69 6b 65 20 69 6e 70 75 74  shell like input
06e0: 20 69 6e 74 65 72 66 61 63 65 2e 20 49 6e 20 74   interface. In t
06f0: 68 69 73 20 63 61 73 65 20 74 68 65 0a 5c 66 42  his case the.\fB
0700: 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 72  ::tclreadline::r
0710: 65 61 64 6c 69 6e 65 20 72 65 61 64 5c 66 50 20  eadline read\fP 
0720: 63 6f 6d 6d 61 6e 64 20 68 61 73 20 74 6f 20 62  command has to b
0730: 65 20 63 61 6c 6c 65 64 20 65 78 70 6c 69 63 69  e called explici
0740: 74 6c 79 2e 0a 0a 2e 50 50 0a 0a 54 68 65 20 61  tly....PP..The a
0750: 64 76 61 6e 74 61 67 65 20 6f 66 20 5c 66 42 74  dvantage of \fBt
0760: 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50 20 69 73  clreadline\fP is
0770: 20 74 68 61 74 20 69 74 20 75 73 65 73 20 74 68   that it uses th
0780: 65 20 63 61 6c 6c 62 61 63 6b 0a 68 61 6e 64 6c  e callback.handl
0790: 65 72 20 6d 65 63 68 61 6e 69 73 6d 20 6f 66 20  er mechanism of 
07a0: 74 68 65 20 67 6e 75 20 72 65 61 64 6c 69 6e 65  the gnu readline
07b0: 20 77 68 69 6c 65 20 69 74 20 70 72 6f 63 65 73   while it proces
07c0: 73 65 73 20 74 63 6c 0a 65 76 65 6e 74 73 2e 20  ses tcl.events. 
07d0: 54 68 69 73 20 77 61 79 20 58 20 65 76 65 6e 74  This way X event
07e0: 73 20 66 72 6f 6d 20 61 20 77 69 73 68 20 67 75  s from a wish gu
07f0: 69 20 77 69 6c 6c 20 70 72 6f 63 65 73 73 65 64  i will processed
0800: 20 61 73 0a 77 65 6c 6c 20 61 73 20 65 76 65 6e   as.well as even
0810: 74 73 20 66 72 6f 6d 20 74 68 65 20 5c 66 50 74  ts from the \fPt
0820: 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50 20 6c 69  clreadline\fP li
0830: 6e 65 20 69 6e 74 65 72 66 61 63 65 2e 0a 0a 2e  ne interface....
0840: 50 50 0a 0a 5c 66 42 74 63 6c 72 65 61 64 6c 69  PP..\fBtclreadli
0850: 6e 65 5c 66 50 20 69 73 20 62 61 73 69 63 61 6c  ne\fP is basical
0860: 6c 79 20 61 20 73 68 61 72 65 64 20 6c 69 62 72  ly a shared libr
0870: 61 72 79 20 61 6e 64 20 61 20 66 65 77 20 74 63  ary and a few tc
0880: 6c 20 73 63 72 69 70 74 73 0a 77 68 69 63 68 20  l scripts.which 
0890: 61 72 65 20 61 63 63 65 73 73 65 64 20 77 69 74  are accessed wit
08a0: 68 20 74 68 65 20 74 63 6c 20 70 61 63 6b 61 67  h the tcl packag
08b0: 65 20 72 65 71 75 69 72 65 20 63 6f 6d 6d 61 6e  e require comman
08c0: 64 2e 20 54 68 65 72 65 66 6f 72 65 0a 5c 66 42  d. Therefore.\fB
08d0: 74 63 6c 72 65 61 64 6c 69 6e 65 5c 66 50 20 73  tclreadline\fP s
08e0: 68 6f 75 6c 64 20 77 6f 72 6b 20 77 69 74 68 20  hould work with 
08f0: 61 6c 6c 20 63 6f 6d 6d 6f 6e 20 65 78 74 65 6e  all common exten
0900: 73 69 6f 6e 73 20 6c 69 6b 65 0a 5c 66 42 62 6c  sions like.\fBbl
0910: 74 2c 20 69 74 63 6c 2c 20 69 74 6b 2c 20 74 69  t, itcl, itk, ti
0920: 78 20 2e 2e 2e 5c 66 50 2e 0a 0a 0a 2e 5c 22 2e  x ...\fP.....\".
0930: 53 48 20 53 4f 55 52 43 45 20 46 49 4c 45 53 0a  SH SOURCE FILES.
0940: 0a 0a 2e 53 48 20 43 4f 4d 4d 41 4e 44 53 0a 0a  ...SH COMMANDS..
0950: 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 75  If you want to u
0960: 73 65 20 5c 66 42 74 63 6c 72 65 61 64 6c 69 6e  se \fBtclreadlin
0970: 65 5c 66 50 20 61 73 20 61 20 6c 69 6e 65 20 69  e\fP as a line i
0980: 6e 74 65 72 66 61 63 65 0a 66 6f 72 20 64 65 76  nterface.for dev
0990: 65 6c 6f 70 69 6e 67 20 74 63 6c 20 73 63 72 69  eloping tcl scri
09a0: 70 74 73 2c 20 79 6f 75 20 70 72 6f 62 61 62 6c  pts, you probabl
09b0: 79 20 64 6f 6e 27 74 20 68 61 76 65 20 74 6f 20  y don't have to 
09c0: 72 65 61 64 0a 74 68 69 73 20 73 65 63 74 69 6f  read.this sectio
09d0: 6e 2e 0a 0a 2e 50 50 0a 54 68 65 20 66 6f 6c 6c  n....PP.The foll
09e0: 6f 77 69 6e 67 20 6c 69 73 74 20 77 69 6c 6c 20  owing list will 
09f0: 67 69 76 65 20 61 6c 6c 20 63 6f 6d 6d 61 6e 64  give all command
0a00: 73 2c 20 77 68 69 63 68 20 61 72 65 20 63 75 72  s, which are cur
0a10: 72 65 6e 74 6c 79 0a 69 6d 70 6c 65 6d 65 6e 74  rently.implement
0a20: 65 64 20 69 6e 20 74 68 65 20 73 68 61 72 65 64  ed in the shared
0a30: 20 6c 69 62 20 28 65 2e 67 2e 20 6c 69 62 74 63   lib (e.g. libtc
0a40: 6c 72 65 61 64 6c 69 6e 65 30 2e 37 2e 73 6f 29  lreadline0.7.so)
0a50: 2e 0a 41 64 64 69 74 69 6f 6e 61 6c 20 63 6f 6d  ..Additional com
0a60: 6d 61 6e 64 73 20 77 65 72 65 20 69 6e 74 72 6f  mands were intro
0a70: 64 75 63 65 64 20 69 6e 20 61 20 73 74 61 72 74  duced in a start
0a80: 75 70 20 73 63 72 69 70 74 0a 5c 66 42 74 63 6c  up script.\fBtcl
0a90: 72 65 61 64 6c 69 6e 65 53 65 74 75 70 2e 74 63  readlineSetup.tc
0aa0: 6c 5c 66 50 2c 20 77 68 69 63 68 20 6c 69 76 65  l\fP, which live
0ab0: 73 20 69 6e 20 74 68 65 20 74 63 6c 72 65 61 64  s in the tclread
0ac0: 6c 69 6e 65 0a 69 6e 73 74 61 6c 6c 61 74 69 6f  line.installatio
0ad0: 6e 20 64 69 72 65 63 74 6f 72 79 2e 0a 28 74 79  n directory..(ty
0ae0: 70 69 63 61 6c 6c 79 20 73 6f 6d 65 74 68 69 6e  pically somethin
0af0: 67 20 6c 69 6b 65 20 2f 75 73 72 2f 6c 6f 63 61  g like /usr/loca
0b00: 6c 2f 6c 69 62 2f 74 63 6c 72 65 61 64 6c 69 6e  l/lib/tclreadlin
0b10: 65 20 2e 2e 29 0a 54 68 65 73 65 20 63 6f 6d 6d  e ..).These comm
0b20: 61 6e 64 73 20 61 72 65 20 70 72 69 6d 61 72 69  ands are primari
0b30: 6c 79 20 66 6f 72 20 69 6e 74 65 72 6e 61 6c 20  ly for internal 
0b40: 75 73 65 20 61 6e 64 20 6e 6f 74 20 64 6f 63 75  use and not docu
0b50: 6d 65 6e 74 65 64 20 68 65 72 65 2e 0a 0a 4e 6f  mented here...No
0b60: 74 65 20 74 68 61 74 20 61 6c 6c 20 63 6f 6d 6d  te that all comm
0b70: 61 6e 64 73 20 72 65 73 69 64 65 20 69 6e 20 74  ands reside in t
0b80: 68 65 20 6e 61 6d 65 73 70 61 63 65 20 5c 66 42  he namespace \fB
0b90: 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 5c  ::tclreadline::\
0ba0: 66 50 2e 0a 0a 0a 2e 54 50 20 35 0a 5c 66 42 3a  fP.....TP 5.\fB:
0bb0: 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 72 65  :tclreadline::re
0bc0: 61 64 6c 69 6e 65 20 61 64 64 5c 66 50 20 5c 66  adline add\fP \f
0bd0: 49 73 74 72 69 6e 67 5c 66 50 0a 61 64 64 73 20  Istring\fP.adds 
0be0: 61 20 73 74 72 69 6e 67 20 74 6f 20 74 68 65 20  a string to the 
0bf0: 63 6f 6d 70 6c 65 74 65 72 2e 20 49 66 20 74 68  completer. If th
0c00: 65 20 73 74 72 69 6e 67 20 63 6f 6e 74 61 69 6e  e string contain
0c10: 73 20 77 68 69 74 65 0a 73 70 61 63 65 73 2c 20  s white.spaces, 
0c20: 65 61 63 68 20 6f 66 20 74 68 65 20 77 6f 72 64  each of the word
0c30: 73 20 77 69 6c 6c 20 62 65 20 63 6f 6d 70 6c 65  s will be comple
0c40: 74 65 64 20 63 6f 6e 73 65 63 75 74 69 76 65 6c  ted consecutivel
0c50: 79 20 77 68 65 6e 0a 68 69 74 74 69 6e 67 20 3c  y when.hitting <
0c60: 54 61 62 3e 2e 20 45 78 61 6d 70 6c 65 3a 0a 0a  Tab>. Example:..
0c70: 20 20 20 20 3a 3a 74 63 6c 72 65 61 64 6c 69 6e      ::tclreadlin
0c80: 65 3a 3a 72 65 61 64 6c 69 6e 65 20 61 64 64 20  e::readline add 
0c90: 22 62 75 74 74 6f 6e 20 70 61 74 68 4e 61 6d 65  "button pathName
0ca0: 20 3f 6f 70 74 69 6f 6e 73 3f 22 0a 0a 74 79 70   ?options?"..typ
0cb0: 69 6e 67 20 62 75 74 3c 54 61 62 3e 20 77 69 6c  ing but<Tab> wil
0cc0: 6c 20 63 6f 6d 70 6c 65 74 65 20 74 6f 20 62 75  l complete to bu
0cd0: 74 74 6f 6e 2e 20 48 69 74 74 69 6e 67 20 3c 54  tton. Hitting <T
0ce0: 61 62 3e 20 61 67 61 69 6e 0a 77 69 6c 6c 20 63  ab> again.will c
0cf0: 6f 6d 70 6c 65 74 65 20 74 6f 20 22 62 75 74 74  omplete to "butt
0d00: 6f 6e 20 70 61 74 68 4e 61 6d 65 22 2e 20 20 2e  on pathName".  .
0d10: 2e 2e 0a 0a 2e 54 50 20 35 0a 5c 66 42 3a 3a 74  .....TP 5.\fB::t
0d20: 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 72 65 61 64  clreadline::read
0d30: 6c 69 6e 65 20 63 6f 6d 70 6c 65 74 65 5c 66 50  line complete\fP
0d40: 20 5c 66 49 73 74 72 69 6e 67 5c 66 50 0a 72 65   \fIstring\fP.re
0d50: 74 75 72 6e 73 20 31 20 69 66 20 5c 66 49 73 74  turns 1 if \fIst
0d60: 72 69 6e 67 5c 66 50 20 69 73 20 61 20 63 6f 6d  ring\fP is a com
0d70: 70 6c 65 74 65 20 74 63 6c 20 63 6f 6d 6d 61 6e  plete tcl comman
0d80: 64 20 61 6e 64 20 30 20 6f 74 68 65 72 77 69 73  d and 0 otherwis
0d90: 65 2e 0a 0a 2e 54 50 20 35 0a 5c 66 42 3a 3a 74  e....TP 5.\fB::t
0da0: 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 72 65 61 64  clreadline::read
0db0: 6c 69 6e 65 20 69 6e 69 74 69 61 6c 69 7a 65 5c  line initialize\
0dc0: 66 50 20 5c 66 49 68 69 73 74 6f 72 79 66 69 6c  fP \fIhistoryfil
0dd0: 65 5c 66 50 0a 69 6e 69 74 69 61 6c 69 7a 65 20  e\fP.initialize 
0de0: 74 68 65 20 74 63 6c 72 65 61 64 6c 69 6e 65 20  the tclreadline 
0df0: 69 6e 74 65 72 66 61 63 65 20 61 6e 64 20 72 65  interface and re
0e00: 61 64 20 74 68 65 20 68 69 73 74 6f 72 79 20 66  ad the history f
0e10: 72 6f 6d 0a 74 68 65 20 5c 66 49 68 69 73 74 6f  rom.the \fIhisto
0e20: 72 79 66 69 6c 65 5c 66 50 2e 20 4f 6e 20 73 75  ryfile\fP. On su
0e30: 63 63 65 73 20 61 6e 20 65 6d 70 74 79 20 73 74  cces an empty st
0e40: 72 69 6e 67 20 69 73 20 72 65 74 75 72 6e 65 64  ring is returned
0e50: 2e 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 68  ..This command h
0e60: 61 73 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20  as to be called 
0e70: 62 65 66 6f 72 65 20 61 6e 79 20 6f 74 68 65 72  before any other
0e80: 20 74 63 6c 72 65 61 64 6c 69 6e 65 20 63 6f 6d   tclreadline com
0e90: 6d 61 6e 64 73 2e 0a 0a 0a 2e 54 50 20 35 0a 5c  mands.....TP 5.\
0ea0: 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65 3a  fB::tclreadline:
0eb0: 3a 72 65 61 64 6c 69 6e 65 20 72 65 61 64 5c 66  :readline read\f
0ec0: 50 20 5c 66 49 70 72 6f 6d 70 74 5c 66 50 0a 70  P \fIprompt\fP.p
0ed0: 72 69 6e 74 73 20 74 68 65 20 5c 66 49 70 72 6f  rints the \fIpro
0ee0: 6d 70 74 5c 66 50 20 74 6f 20 73 74 64 6f 75 74  mpt\fP to stdout
0ef0: 20 61 6e 64 20 65 6e 74 65 72 73 20 74 68 65 20   and enters the 
0f00: 74 63 6c 72 65 61 64 6c 69 6e 65 20 65 76 65 6e  tclreadline even
0f10: 74 0a 6c 6f 6f 70 2e 20 42 6f 74 68 20 72 65 61  t.loop. Both rea
0f20: 64 6c 69 6e 65 20 61 6e 64 20 58 20 65 76 65 6e  dline and X even
0f30: 74 73 20 61 72 65 20 70 72 6f 63 65 73 73 65 64  ts are processed
0f40: 2e 20 52 65 74 75 72 6e 73 20 74 68 65 0a 28 65  . Returns the.(e
0f50: 76 65 6e 74 75 61 6c 6c 79 20 68 69 73 74 6f 72  ventually histor
0f60: 79 2d 65 78 70 61 6e 64 65 64 29 20 69 6e 70 75  y-expanded) inpu
0f70: 74 20 73 74 72 69 6e 67 2e 0a 0a 0a 2e 54 50 20  t string.....TP 
0f80: 35 0a 5c 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69  5.\fB::tclreadli
0f90: 6e 65 3a 3a 72 65 61 64 6c 69 6e 65 20 77 72 69  ne::readline wri
0fa0: 74 65 5c 66 50 20 5c 66 49 68 69 73 74 6f 72 79  te\fP \fIhistory
0fb0: 66 69 6c 65 5c 66 50 0a 77 72 69 74 65 73 20 74  file\fP.writes t
0fc0: 68 65 20 68 69 73 74 6f 72 79 20 74 6f 20 74 68  he history to th
0fd0: 65 20 5c 66 49 68 69 73 74 6f 72 79 66 69 6c 65  e \fIhistoryfile
0fe0: 5c 66 50 2e 20 54 68 69 73 20 63 6f 6d 6d 61 6e  \fP. This comman
0ff0: 64 20 69 73 20 63 61 6c 6c 65 64 0a 61 75 74 6f  d is called.auto
1000: 6d 61 74 69 63 61 6c 6c 79 20 66 72 6f 6d 20 74  matically from t
1010: 68 65 20 69 6e 74 65 72 6e 61 6c 20 72 6f 75 74  he internal rout
1020: 69 6e 65 20 3a 3a 74 63 6c 72 65 61 64 6c 69 6e  ine ::tclreadlin
1030: 65 3a 3a 45 78 69 74 2e 0a 0a 2e 54 50 20 35 0a  e::Exit....TP 5.
1040: 5c 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65  \fB::tclreadline
1050: 3a 3a 50 72 69 6e 74 5c 66 50 20 5b 5c 66 49 79  ::Print\fP [\fIy
1060: 65 73 20 2f 20 6e 6f 5c 66 50 5d 0a 74 75 72 6e  es / no\fP].turn
1070: 73 20 6f 6e 20 6f 72 20 6f 66 66 20 74 68 65 20  s on or off the 
1080: 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72  default behavior
1090: 20 6f 66 20 74 63 6c 73 68 20 74 6f 20 70 72 69   of tclsh to pri
10a0: 6e 74 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66  nt the result of
10b0: 0a 65 76 65 72 79 20 63 6f 6d 6d 61 6e 64 2e 20  .every command. 
10c0: 54 68 69 73 20 69 73 20 74 75 72 6e 65 64 20 6f  This is turned o
10d0: 6e 20 62 79 20 64 65 66 61 75 6c 74 2c 20 73 6f  n by default, so
10e0: 20 69 74 20 77 69 6c 6c 20 6a 75 73 74 20 62 65   it will just be
10f0: 68 61 76 65 0a 61 73 20 74 68 65 20 74 63 6c 73  have.as the tcls
1100: 68 20 77 2f 6f 20 74 63 6c 72 65 61 64 6c 69 6e  h w/o tclreadlin
1110: 65 2e 20 54 75 72 6e 69 6e 67 20 6f 66 66 20 6d  e. Turning off m
1120: 69 67 68 74 20 62 65 20 75 73 65 66 75 6c 2c 20  ight be useful, 
1130: 77 68 65 6e 20 72 65 61 64 69 6e 67 0a 62 69 6e  when reading.bin
1140: 61 72 79 20 64 61 74 61 20 66 6f 72 20 65 78 61  ary data for exa
1150: 6d 70 6c 65 2e 20 49 66 20 5c 66 42 3a 3a 74 63  mple. If \fB::tc
1160: 6c 72 65 61 64 6c 69 6e 65 3a 3a 50 72 69 6e 74  lreadline::Print
1170: 5c 66 50 20 69 73 20 63 61 6c 6c 65 64 20 77 2f  \fP is called w/
1180: 6f 0a 61 72 67 75 6d 65 6e 74 73 2c 20 69 74 20  o.arguments, it 
1190: 6a 75 73 74 20 72 65 74 75 72 6e 73 20 74 68 65  just returns the
11a0: 20 63 75 72 72 65 6e 74 20 73 65 74 74 69 6e 67   current setting
11b0: 2e 0a 0a 2e 54 50 20 35 0a 5c 66 42 3a 3a 74 63  ....TP 5.\fB::tc
11c0: 6c 72 65 61 64 6c 69 6e 65 3a 3a 4c 6f 6f 70 5c  lreadline::Loop\
11d0: 66 50 0a 65 6e 74 65 72 20 74 68 65 20 74 63 6c  fP.enter the tcl
11e0: 72 65 61 64 6c 69 6e 65 20 6d 61 69 6e 20 6c 6f  readline main lo
11f0: 6f 70 2e 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64  op. This command
1200: 20 69 73 20 74 79 70 69 63 61 6c 6c 79 20 63 61   is typically ca
1210: 6c 6c 65 64 20 66 72 6f 6d 0a 74 68 65 20 73 74  lled from.the st
1220: 61 72 74 75 70 20 72 65 73 6f 75 72 63 65 20 66  artup resource f
1230: 69 6c 65 20 28 73 6f 6d 65 74 68 69 6e 67 20 2e  ile (something .
1240: 74 63 6c 73 68 72 63 2c 20 64 65 70 65 6e 64 69  tclshrc, dependi
1250: 6e 67 20 6f 6e 20 74 68 65 20 69 6e 74 65 72 70  ng on the interp
1260: 72 65 74 65 72 0a 79 6f 75 20 75 73 65 29 2e 20  reter.you use). 
1270: 5c 66 42 3a 3a 74 63 6c 72 65 61 64 6c 69 6e 65  \fB::tclreadline
1280: 3a 3a 4c 6f 6f 70 5c 66 50 20 77 69 6c 6c 20 6e  ::Loop\fP will n
1290: 6f 72 6d 61 6c 6c 79 20 6e 6f 74 20 72 65 74 75  ormally not retu
12a0: 72 6e 2e 0a 0a 2e 5c 22 2e 53 48 20 22 45 58 41  rn....\".SH "EXA
12b0: 4d 50 4c 45 53 22 0a 0a 0a 2e 5c 22 2e 53 48 20  MPLES"....\".SH 
12c0: 22 45 4e 56 49 52 4f 4e 4d 45 4e 54 20 56 41 52  "ENVIRONMENT VAR
12d0: 49 41 42 4c 45 53 22 0a 0a 2e 53 48 20 56 41 52  IABLES"...SH VAR
12e0: 49 41 42 4c 45 53 0a 0a 54 68 65 20 67 6c 6f 62  IABLES..The glob
12f0: 61 6c 20 76 61 72 69 61 62 6c 65 20 5c 66 42 74  al variable \fBt
1300: 63 6c 72 65 61 64 6c 69 6e 65 5f 76 65 72 73 69  clreadline_versi
1310: 6f 6e 5c 66 50 20 68 6f 6c 64 73 20 74 68 65 20  on\fP holds the 
1320: 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 0a 6f  version number.o
1330: 66 20 74 68 65 20 74 63 6c 72 65 61 64 6c 69 6e  f the tclreadlin
1340: 65 20 70 61 63 6b 61 67 65 2e 0a 0a 2e 53 48 20  e package....SH 
1350: 46 49 4c 45 53 0a 0a 74 68 65 20 5c 66 42 2e 74  FILES..the \fB.t
1360: 63 6c 73 68 72 63 5c 66 50 20 66 69 6c 65 20 69  clshrc\fP file i
1370: 6e 20 74 68 65 20 48 4f 4d 45 20 64 69 72 65 63  n the HOME direc
1380: 74 6f 72 79 2c 20 77 68 69 63 68 0a 69 73 20 72  tory, which.is r
1390: 65 61 64 20 6f 6e 20 74 63 6c 73 68 20 73 74 61  ead on tclsh sta
13a0: 72 74 75 70 2e 20 41 6c 74 65 72 6e 61 74 69 76  rtup. Alternativ
13b0: 65 6c 79 2c 20 74 68 65 20 6e 61 6d 65 20 6f 66  ely, the name of
13c0: 20 74 68 69 73 20 69 6e 69 74 69 61 6c 69 7a 61   this initializa
13d0: 74 69 6f 6e 0a 66 69 6c 65 20 6d 69 67 68 74 20  tion.file might 
13e0: 62 65 20 5c 66 42 2e 77 69 73 68 72 63 5c 66 50  be \fB.wishrc\fP
13f0: 20 2e 2e 2e 20 64 65 70 65 6e 64 69 6e 67 20 6f   ... depending o
1400: 6e 20 77 68 61 74 20 69 6e 74 65 72 70 72 65 74  n what interpret
1410: 65 72 20 79 6f 75 20 75 73 65 2e 0a 54 68 65 73  er you use..Thes
1420: 65 20 66 69 6c 65 73 20 73 68 6f 75 6c 64 20 74  e files should t
1430: 79 70 69 63 61 6c 6c 79 20 63 6f 6e 74 61 69 6e  ypically contain
1440: 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 0a   something like.
1450: 0a 2e 45 51 0a 20 20 20 20 69 66 20 7b 24 74 63  ..EQ.    if {$tc
1460: 6c 5f 69 6e 74 65 72 61 63 74 69 76 65 7d 20 7b  l_interactive} {
1470: 0a 20 20 20 20 20 20 20 20 70 61 63 6b 61 67 65  .        package
1480: 20 72 65 71 75 69 72 65 20 74 63 6c 72 65 61 64   require tclread
1490: 6c 69 6e 65 0a 20 20 20 20 20 20 20 20 3a 3a 74  line.        ::t
14a0: 63 6c 72 65 61 64 6c 69 6e 65 3a 3a 4c 6f 6f 70  clreadline::Loop
14b0: 0a 20 20 20 20 7d 0a 2e 45 4e 0a 0a 77 68 69 63  .    }..EN..whic
14c0: 68 20 77 69 6c 6c 20 65 6e 74 65 72 20 74 68 65  h will enter the
14d0: 20 74 63 6c 72 65 61 64 6c 69 6e 65 20 6d 61 69   tclreadline mai
14e0: 6e 20 6c 6f 6f 70 2e 0a 0a 2e 50 50 0a 74 68 65  n loop....PP.the
14f0: 20 5c 66 42 2e 74 63 6c 73 68 2d 68 69 73 74 6f   \fB.tclsh-histo
1500: 72 79 5c 66 50 20 66 69 6c 65 20 69 6e 20 74 68  ry\fP file in th
1510: 65 20 48 4f 4d 45 20 64 69 72 65 63 74 6f 72 79  e HOME directory
1520: 2e 20 4f 6e 20 73 74 61 72 74 75 70 0a 63 6f 6d  . On startup.com
1530: 6d 61 6e 64 73 20 77 69 6c 6c 20 62 65 20 72 65  mands will be re
1540: 61 64 20 66 72 6f 6d 20 74 68 69 73 20 66 69 6c  ad from this fil
1550: 65 2e 20 4f 6e 20 65 78 69 74 2c 20 74 68 65 20  e. On exit, the 
1560: 72 65 61 64 6c 69 6e 65 20 68 69 73 74 6f 72 79  readline history
1570: 0a 69 73 20 77 72 69 74 74 65 6e 20 74 6f 20 74  .is written to t
1580: 68 69 73 20 66 69 6c 65 2e 20 4e 6f 74 65 20 74  his file. Note t
1590: 68 61 74 20 69 66 20 79 6f 75 20 61 62 6f 72 74  hat if you abort
15a0: 20 74 63 6c 73 68 20 77 69 74 68 20 3c 63 6e 74   tclsh with <cnt
15b0: 72 6c 2d 63 3e 0a 6e 6f 20 68 69 73 74 6f 72 79  rl-c>.no history
15c0: 20 69 73 20 77 72 69 74 74 65 6e 2e 20 46 6f 72   is written. For
15d0: 20 74 68 65 20 66 75 74 75 72 65 20 69 74 20 69   the future it i
15e0: 73 20 70 6c 61 6e 6e 65 64 20 74 6f 20 73 65 74  s planned to set
15f0: 20 75 70 20 61 20 73 69 67 6e 61 6c 0a 68 61 6e   up a signal.han
1600: 64 6c 65 72 2c 20 77 68 69 63 68 20 77 69 6c 6c  dler, which will
1610: 20 77 72 69 74 65 20 74 68 65 20 68 69 73 74 6f   write the histo
1620: 72 79 20 6f 6e 20 3c 63 74 72 6c 2d 63 3e 20 62  ry on <ctrl-c> b
1630: 65 66 6f 72 65 20 65 78 69 74 69 6e 67 2e 0a 0a  efore exiting...
1640: 2e 50 50 0a 74 68 65 20 5c 66 42 2e 69 6e 70 75  .PP.the \fB.inpu
1650: 74 72 63 5c 66 50 20 66 69 6c 65 20 69 6e 20 74  trc\fP file in t
1660: 68 65 20 75 73 65 72 73 20 48 4f 4d 45 20 64 69  he users HOME di
1670: 72 65 63 74 6f 72 79 2e 20 54 68 69 73 20 66 69  rectory. This fi
1680: 6c 65 0a 69 73 20 75 73 65 64 20 6e 6f 72 6d 61  le.is used norma
1690: 6c 6c 79 20 66 6f 72 20 61 6c 6c 20 70 72 6f 67  lly for all prog
16a0: 72 61 6d 73 20 77 68 69 63 68 20 75 73 65 20 74  rams which use t
16b0: 68 65 20 67 6e 75 20 72 65 61 64 6c 69 6e 65 20  he gnu readline 
16c0: 28 65 2e 67 2e 20 20 62 61 73 68 29 2e 0a 54 68  (e.g.  bash)..Th
16d0: 65 20 60 67 6c 6f 62 61 6c 27 20 72 65 61 64 6c  e `global' readl
16e0: 69 6e 65 20 73 65 74 74 69 6e 67 73 20 74 68 65  ine settings the
16f0: 72 65 20 77 69 6c 6c 20 62 65 20 76 61 6c 69 64  re will be valid
1700: 20 61 6c 73 6f 20 66 6f 72 0a 5c 66 42 74 63 6c   also for.\fBtcl
1710: 72 65 61 64 6c 69 6e 65 5c 66 50 2e 20 41 64 64  readline\fP. Add
1720: 69 74 69 6f 6e 61 6c 6c 79 20 74 68 65 20 2e 69  itionally the .i
1730: 6e 70 75 74 72 63 20 6d 69 67 68 74 20 68 6f 6c  nputrc might hol
1740: 64 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 0a 73 65  d conditional.se
1750: 74 74 69 6e 67 73 20 66 6f 72 20 74 68 65 20 69  ttings for the i
1760: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6e 61  mplementation na
1770: 6d 65 20 5c 66 42 74 63 6c 72 65 61 64 6c 69 6e  me \fBtclreadlin
1780: 65 5c 66 50 2e 20 45 78 61 6d 70 6c 65 20 6f 66  e\fP. Example of
1790: 20 0a 73 6f 6d 65 20 6c 69 6e 65 73 20 69 6e 20   .some lines in 
17a0: 79 6f 75 72 20 2e 69 6e 70 75 74 72 63 3a 0a 0a  your .inputrc:..
17b0: 2e 45 51 0a 20 20 20 20 24 69 66 20 74 63 6c 72  .EQ.    $if tclr
17c0: 65 61 64 6c 69 6e 65 0a 20 20 20 20 22 5c 43 2d  eadline.    "\C-
17d0: 78 70 22 3a 20 22 70 75 74 73 20 24 65 6e 76 28  xp": "puts $env(
17e0: 50 41 54 48 29 22 0a 20 20 20 20 24 65 6e 64 69  PATH)".    $endi
17f0: 66 0a 2e 45 4e 0a 0a 46 6f 72 20 66 75 72 74 68  f..EN..For furth
1800: 65 72 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e  er documentation
1810: 20 70 6c 65 61 73 65 20 72 65 66 65 72 20 74 6f   please refer to
1820: 20 74 68 65 20 67 6e 75 20 72 65 61 64 6c 69 6e   the gnu readlin
1830: 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e  e documentation.
1840: 0a 0a 2e 53 48 20 42 55 47 53 0a 70 72 6f 62 61  ...SH BUGS.proba
1850: 62 6c 79 2e 0a 0a 0a 2e 53 48 20 22 53 45 45 20  bly.....SH "SEE 
1860: 41 4c 53 4f 22 0a 0a 0a 2e 50 50 0a 54 68 65 20  ALSO"....PP.The 
1870: 6f 66 66 69 63 69 61 6c 20 5c 66 42 74 63 6c 72  official \fBtclr
1880: 65 61 64 6c 69 6e 65 5c 66 50 20 77 65 62 20 73  eadline\fP web s
1890: 69 74 65 20 61 74 3a 0a 0a 2e 50 50 0a 2e 52 53  ite at:...PP..RS
18a0: 20 34 0a 68 74 74 70 3a 2f 2f 6b 72 69 73 61 6c   4.http://krisal
18b0: 2e 70 68 79 73 69 6b 2e 75 6e 69 2d 6b 61 72 6c  .physik.uni-karl
18c0: 73 72 75 68 65 2e 64 65 2f 74 63 6c 72 65 61 64  sruhe.de/tclread
18d0: 6c 69 6e 65 2f 69 6e 64 65 78 2e 68 74 6d 6c 0a  line/index.html.
18e0: 2e 52 45 0a 0a 0a 2e 53 48 20 41 55 54 48 4f 52  .RE....SH AUTHOR
18f0: 28 53 29 0a 4a 6f 68 61 6e 6e 65 73 20 5a 65 6c  (S).Johannes Zel
1900: 6c 6e 65 72 0a 2e 62 72 0a 3c 4a 6f 68 61 6e 6e  lner..br.<Johann
1910: 65 73 2e 5a 65 6c 6c 6e 65 72 40 70 68 79 73 69  es.Zellner@physi
1920: 6b 2e 75 6e 69 2d 6b 61 72 6c 73 72 75 68 65 2e  k.uni-karlsruhe.
1930: 64 65 3e 0a 2e 62 72 0a 49 66 20 79 6f 75 20 77  de>..br.If you w
1940: 61 6e 74 20 74 6f 20 62 65 20 6c 69 73 74 65 64  ant to be listed
1950: 20 68 65 72 65 2c 20 79 6f 75 20 68 61 76 65 20   here, you have 
1960: 74 6f 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f  to contribute to
1970: 20 74 68 65 20 63 6f 64 65 20 3a 2d 29 0a 28 73   the code :-).(s
1980: 65 65 20 62 65 6c 6f 77 29 2e 0a 0a 0a 2e 53 48  ee below).....SH
1990: 20 48 49 53 54 4f 52 59 0a 54 68 69 73 20 76 65   HISTORY.This ve
19a0: 72 73 69 6f 6e 20 6f 66 20 5c 66 42 74 63 6c 72  rsion of \fBtclr
19b0: 65 61 64 6c 69 6e 65 5c 66 50 20 69 73 20 73 74  eadline\fP is st
19c0: 69 6c 6c 20 61 20 64 65 76 65 6c 6f 70 6d 65 6e  ill a developmen
19d0: 74 20 76 65 72 73 69 6f 6e 2e 0a 50 72 65 74 74  t version..Prett
19e0: 79 20 61 20 6c 6f 74 20 6f 66 20 66 65 61 74 75  y a lot of featu
19f0: 72 65 73 20 61 6e 64 20 69 64 65 61 73 20 61 72  res and ideas ar
1a00: 65 20 6e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 65  e not implemente
1a10: 64 20 79 65 74 2e 20 54 68 65 0a 72 65 61 73 6f  d yet. The.reaso
1a20: 6e 20 66 6f 72 20 74 68 69 73 20 69 73 20 74 68  n for this is th
1a30: 65 20 6c 61 63 6b 20 6f 66 20 74 69 6d 65 20 61  e lack of time a
1a40: 6e 64 20 6d 61 6e 70 6f 77 65 72 2e 0a 53 6f 20  nd manpower..So 
1a50: 79 6f 75 20 61 72 65 20 77 65 6c 63 6f 6d 65 20  you are welcome 
1a60: 74 6f 20 6d 6f 64 69 66 79 20 61 6e 64 20 63 6f  to modify and co
1a70: 6e 74 72 69 62 75 74 65 20 74 6f 20 74 68 65 20  ntribute to the 
1a80: 63 6f 64 65 2e 0a 49 66 20 79 6f 75 20 68 61 76  code..If you hav
1a90: 65 20 73 75 67 67 65 73 74 69 6f 6e 73 2c 20 70  e suggestions, p
1aa0: 6c 65 61 73 65 20 6c 65 74 20 6d 65 20 6b 6e 6f  lease let me kno
1ab0: 77 2e 0a 0a 0a                                   w....