Hex Artifact Content

Artifact 0ea106f5669f9c141b7f9f1d1d53e6f0bb1e6d3b:


0000: 54 68 65 20 43 54 6b 20 54 6f 6f 6c 6b 69 74 0a  The CTk Toolkit.
0010: 0a 62 79 20 4d 61 72 74 69 6e 20 41 6e 64 72 65  .by Martin Andre
0020: 77 73 0a 61 6e 64 72 65 77 6d 40 63 63 66 61 64  ws.andrewm@ccfad
0030: 6d 2e 65 65 67 2e 63 63 66 2e 6f 72 67 0a 0a 40  m.eeg.ccf.org..@
0040: 28 23 29 20 24 49 64 3a 20 63 74 6b 2e 73 68 61  (#) $Id: ctk.sha
0050: 72 2c 76 20 31 2e 35 30 20 31 39 39 36 2f 30 31  r,v 1.50 1996/01
0060: 2f 31 35 20 31 34 3a 34 37 3a 31 36 20 61 6e 64  /15 14:47:16 and
0070: 72 65 77 6d 20 45 78 70 20 61 6e 64 72 65 77 6d  rewm Exp andrewm
0080: 20 24 0a 0a 31 2e 20 49 6e 74 72 6f 64 75 63 74   $..1. Introduct
0090: 69 6f 6e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ion.------------
00a0: 2d 2d 2d 2d 0a 0a 54 68 69 73 20 64 69 72 65 63  ----..This direc
00b0: 74 6f 72 79 20 63 6f 6e 74 61 69 6e 73 20 74 68  tory contains th
00c0: 65 20 73 6f 75 72 63 65 73 20 66 6f 72 20 43 54  e sources for CT
00d0: 6b 2c 20 61 20 63 75 72 73 65 73 20 70 6f 72 74  k, a curses port
00e0: 20 6f 66 20 4a 6f 68 6e 0a 4f 75 73 74 65 72 68   of John.Ousterh
00f0: 6f 75 74 27 73 20 54 6b 20 74 6f 6f 6c 6b 69 74  out's Tk toolkit
0100: 20 66 6f 72 20 58 31 31 2e 20 20 54 68 65 20 69   for X11.  The i
0110: 6e 66 6f 72 6d 61 74 69 6f 6e 20 68 65 72 65 20  nformation here 
0120: 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 0a 43  corresponds to.C
0130: 54 6b 20 34 2e 30 2e 20 20 43 54 6b 20 34 2e 30  Tk 4.0.  CTk 4.0
0140: 20 69 73 20 62 61 73 65 64 20 6f 6e 20 54 6b 20   is based on Tk 
0150: 34 2e 30 70 33 2e 20 4c 69 6b 65 20 54 6b 20 34  4.0p3. Like Tk 4
0160: 2e 30 70 33 2c 20 69 74 20 69 73 20 64 65 73 69  .0p3, it is desi
0170: 67 6e 65 64 0a 74 6f 20 77 6f 72 6b 20 77 69 74  gned.to work wit
0180: 68 20 54 63 6c 20 37 2e 34 70 33 20 61 6e 64 20  h Tcl 7.4p3 and 
0190: 6d 61 79 20 6e 6f 74 20 77 6f 72 6b 20 77 69 74  may not work wit
01a0: 68 20 6f 74 68 65 72 20 72 65 6c 65 61 73 65 73  h other releases
01b0: 20 6f 66 20 54 63 6c 2e 0a 0a 55 73 69 6e 67 20   of Tcl...Using 
01c0: 43 54 6b 2c 20 61 70 70 6c 69 63 61 74 69 6f 6e  CTk, application
01d0: 73 20 77 69 74 68 20 61 20 6d 6f 64 65 72 6e 20  s with a modern 
01e0: 47 55 49 2d 69 73 68 20 69 6e 74 65 72 66 61 63  GUI-ish interfac
01f0: 65 20 63 61 6e 20 62 65 20 63 72 65 61 74 65 64  e can be created
0200: 0a 66 6f 72 20 63 68 61 72 61 63 74 65 72 20 74  .for character t
0210: 65 72 6d 69 6e 61 6c 73 2e 20 20 54 68 65 73 65  erminals.  These
0220: 20 73 61 6d 65 20 61 70 70 6c 69 63 61 74 69 6f   same applicatio
0230: 6e 73 2c 20 77 69 74 68 6f 75 74 20 6d 6f 64 69  ns, without modi
0240: 66 69 63 61 74 69 6f 6e 2c 0a 63 61 6e 20 70 72  fication,.can pr
0250: 6f 76 69 64 65 20 61 20 72 65 61 6c 20 47 55 49  ovide a real GUI
0260: 20 69 6e 74 65 72 66 61 63 65 20 62 79 20 75 73   interface by us
0270: 69 6e 67 20 54 6b 2e 20 20 54 68 75 73 2c 20 73  ing Tk.  Thus, s
0280: 69 74 65 73 20 77 69 74 68 20 61 6e 0a 65 6d 62  ites with an.emb
0290: 65 64 64 65 64 20 62 61 73 65 20 6f 66 20 63 68  edded base of ch
02a0: 61 72 61 63 74 65 72 20 74 65 72 6d 69 6e 61 6c  aracter terminal
02b0: 73 20 28 61 6e 64 20 61 20 73 6d 61 6c 6c 20 63  s (and a small c
02c0: 61 70 69 74 61 6c 20 62 75 64 67 65 74 29 20 63  apital budget) c
02d0: 61 6e 0a 73 6d 6f 6f 74 68 6c 79 20 6d 69 67 72  an.smoothly migr
02e0: 61 74 65 20 74 6f 20 47 55 49 20 61 70 70 6c 69  ate to GUI appli
02f0: 63 61 74 69 6f 6e 73 2e 0a 0a 32 2e 20 44 6f 63  cations...2. Doc
0300: 75 6d 65 6e 74 61 74 69 6f 6e 0a 2d 2d 2d 2d 2d  umentation.-----
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65  -----------..The
0320: 72 65 20 69 73 20 61 20 6d 61 6e 20 70 61 67 65  re is a man page
0330: 20 66 6f 72 20 63 77 69 73 68 20 28 63 77 69 73   for cwish (cwis
0340: 68 28 31 29 29 20 65 78 70 6c 61 69 6e 69 6e 67  h(1)) explaining
0350: 20 65 78 65 63 75 74 69 6f 6e 20 6f 70 74 69 6f   execution optio
0360: 6e 73 0a 66 6f 72 20 74 68 65 20 43 54 6b 20 73  ns.for the CTk s
0370: 68 65 6c 6c 2e 20 20 46 6f 72 20 73 63 72 69 70  hell.  For scrip
0380: 74 20 77 72 69 74 69 6e 67 2c 20 74 68 65 20 54  t writing, the T
0390: 6b 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2c  k Documentation,
03a0: 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68 65 0a   along with the.
03b0: 6c 69 73 74 20 6f 66 20 64 69 66 66 65 72 65 6e  list of differen
03c0: 63 65 73 20 69 6e 20 73 65 63 74 69 6f 6e 20 35  ces in section 5
03d0: 20 6f 66 20 74 68 69 73 20 64 6f 63 75 6d 65 6e   of this documen
03e0: 74 20 73 68 6f 75 6c 64 20 62 65 20 65 6e 6f 75  t should be enou
03f0: 67 68 20 74 6f 20 67 65 74 0a 73 74 61 72 74 65  gh to get.starte
0400: 64 2e 0a 0a 33 2e 20 43 6f 6d 70 69 6c 69 6e 67  d...3. Compiling
0410: 20 61 6e 64 20 69 6e 73 74 61 6c 6c 69 6e 67 20   and installing 
0420: 43 54 6b 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  CTk.------------
0430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0440: 2d 2d 2d 0a 0a 43 54 6b 20 72 65 71 75 69 72 65  ---..CTk require
0450: 73 20 54 43 4c 20 61 6e 64 20 61 20 53 79 73 74  s TCL and a Syst
0460: 65 6d 20 56 20 63 75 72 73 65 73 20 70 61 63 6b  em V curses pack
0470: 61 67 65 20 28 43 54 6b 20 77 69 6c 6c 20 62 75  age (CTk will bu
0480: 69 6c 64 0a 77 69 74 68 20 42 53 44 20 63 75 72  ild.with BSD cur
0490: 73 65 73 20 62 75 74 20 68 61 73 20 61 74 20 6c  ses but has at l
04a0: 65 61 73 74 20 6f 6e 65 20 64 69 73 70 6c 61 79  east one display
04b0: 20 67 6c 69 74 63 68 20 61 6e 64 20 6d 61 6e 79   glitch and many
04c0: 0a 6d 69 73 73 69 6e 67 20 66 65 61 74 75 72 65  .missing feature
04d0: 73 20 2d 20 73 65 65 20 70 6f 72 74 69 6e 67 2e  s - see porting.
04e0: 6e 6f 74 65 73 20 66 6f 72 20 6d 6f 72 65 20 69  notes for more i
04f0: 6e 66 6f 72 6d 61 74 69 6f 6e 29 2e 0a 55 6e 6c  nformation)..Unl
0500: 69 6b 65 20 54 6b 2c 20 79 6f 75 20 64 6f 20 6e  ike Tk, you do n
0510: 6f 74 20 6e 65 65 64 20 74 68 65 20 73 6f 75 72  ot need the sour
0520: 63 65 20 66 6f 72 20 54 63 6c 20 74 6f 20 62 75  ce for Tcl to bu
0530: 69 6c 64 20 43 54 6b 2e 0a 4f 6e 6c 79 20 74 68  ild CTk..Only th
0540: 65 20 54 63 6c 20 37 2e 34 20 6c 69 62 72 61 72  e Tcl 7.4 librar
0550: 79 20 61 6e 64 20 69 6e 63 6c 75 64 65 20 66 69  y and include fi
0560: 6c 65 20 28 74 63 6c 2e 68 29 20 61 72 65 20 6e  le (tcl.h) are n
0570: 65 63 65 73 73 61 72 79 2e 0a 49 66 20 79 6f 75  ecessary..If you
0580: 72 20 73 79 73 74 65 6d 20 64 6f 65 73 20 6e 6f  r system does no
0590: 74 20 68 61 76 65 20 61 20 53 79 73 74 65 6d 20  t have a System 
05a0: 56 20 63 6f 6d 70 61 74 69 62 6c 65 20 63 75 72  V compatible cur
05b0: 73 65 73 2c 0a 74 68 65 72 65 20 69 73 20 61 20  ses,.there is a 
05c0: 66 72 65 65 20 76 65 72 73 69 6f 6e 2c 20 6e 63  free version, nc
05d0: 75 72 73 65 73 2c 20 61 76 61 69 6c 61 62 6c 65  urses, available
05e0: 20 69 6e 20 47 4e 55 20 61 72 63 68 69 76 65 73   in GNU archives
05f0: 0a 28 66 6f 72 20 69 6e 73 74 61 6e 63 65 20 66  .(for instance f
0600: 74 70 3a 2f 2f 70 72 65 70 2e 61 69 2e 6d 69 74  tp://prep.ai.mit
0610: 2e 65 64 75 2f 70 75 62 2f 67 6e 75 29 2e 0a 0a  .edu/pub/gnu)...
0620: 43 54 6b 20 62 75 69 6c 64 73 20 63 6c 65 61 6e  CTk builds clean
0630: 6c 79 20 6f 6e 20 74 68 65 20 74 68 72 65 65 20  ly on the three 
0640: 73 79 73 74 65 6d 73 20 49 20 68 61 76 65 20 65  systems I have e
0650: 61 73 79 20 61 63 63 65 73 73 20 74 6f 3a 0a 0a  asy access to:..
0660: 20 20 20 20 34 38 36 20 50 43 20 72 75 6e 6e 69      486 PC runni
0670: 6e 67 20 4c 69 6e 75 78 20 31 2e 31 2e 35 34 20  ng Linux 1.1.54 
0680: 75 73 69 6e 67 20 67 63 63 20 32 2e 35 38 20 61  using gcc 2.58 a
0690: 6e 64 20 6e 63 75 72 73 65 73 20 31 2e 38 2e 35  nd ncurses 1.8.5
06a0: 0a 0a 20 20 20 20 48 50 20 39 30 30 30 2f 38 33  ..    HP 9000/83
06b0: 35 20 72 75 6e 6e 69 6e 67 20 48 50 2d 55 58 20  5 running HP-UX 
06c0: 39 2e 30 34 20 75 73 69 6e 67 20 6f 70 74 69 6f  9.04 using optio
06d0: 6e 61 6c 20 41 4e 53 49 20 43 20 63 6f 6d 70 69  nal ANSI C compi
06e0: 6c 65 72 20 61 6e 64 0a 20 20 20 20 6e 63 75 72  ler and.    ncur
06f0: 73 65 73 20 31 2e 38 2e 36 20 6f 72 20 75 73 69  ses 1.8.6 or usi
0700: 6e 67 20 4b 26 52 20 43 20 63 6f 6d 70 69 6c 65  ng K&R C compile
0710: 72 20 61 6e 64 20 68 70 20 63 75 72 73 65 73 20  r and hp curses 
0720: 28 6f 6c 64 20 73 79 73 74 65 6d 20 56 2c 0a 20  (old system V,. 
0730: 20 20 20 6e 6f 74 20 76 65 72 79 20 70 72 65 74     not very pret
0740: 74 79 29 0a 0a 20 20 20 20 53 75 6e 20 34 63 20  ty)..    Sun 4c 
0750: 72 75 6e 6e 69 6e 67 20 53 75 6e 20 4f 53 20 34  running Sun OS 4
0760: 2e 31 33 20 75 73 69 6e 67 20 53 79 73 74 65 6d  .13 using System
0770: 20 56 20 63 6f 6d 70 69 6c 65 72 20 28 2f 75 73   V compiler (/us
0780: 72 2f 35 62 69 6e 2f 63 63 29 0a 20 20 20 20 61  r/5bin/cc).    a
0790: 6e 64 20 53 79 73 74 65 6d 20 56 20 63 75 72 73  nd System V curs
07a0: 65 73 0a 0a 50 65 72 66 6f 72 6d 20 74 68 65 20  es..Perform the 
07b0: 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 65 70 73 20  following steps 
07c0: 74 6f 20 63 6f 6d 70 69 6c 65 20 61 6e 64 20 69  to compile and i
07d0: 6e 73 74 61 6c 6c 20 43 54 6b 3a 0a 0a 20 20 20  nstall CTk:..   
07e0: 20 28 61 29 20 54 79 70 65 20 22 2e 2f 63 6f 6e   (a) Type "./con
07f0: 66 69 67 75 72 65 22 20 69 6e 20 74 68 69 73 20  figure" in this 
0800: 64 69 72 65 63 74 6f 72 79 2e 20 20 54 68 69 73  directory.  This
0810: 20 72 75 6e 73 20 61 20 63 6f 6e 66 69 67 75 72   runs a configur
0820: 61 74 69 6f 6e 0a 09 73 63 72 69 70 74 20 63 72  ation..script cr
0830: 65 61 74 65 64 20 62 79 20 47 4e 55 20 61 75 74  eated by GNU aut
0840: 6f 63 6f 6e 66 2c 20 77 68 69 63 68 20 63 6f 6e  oconf, which con
0850: 66 69 67 75 72 65 73 20 43 54 6b 20 66 6f 72 20  figures CTk for 
0860: 79 6f 75 72 0a 09 73 79 73 74 65 6d 20 61 6e 64  your..system and
0870: 20 63 72 65 61 74 65 73 20 61 20 4d 61 6b 65 66   creates a Makef
0880: 69 6c 65 2e 20 20 49 66 20 79 6f 75 20 61 72 65  ile.  If you are
0890: 20 75 73 69 6e 67 20 6e 63 75 72 73 65 73 2c 20   using ncurses, 
08a0: 61 6e 64 0a 09 74 68 65 20 6c 69 62 72 61 72 79  and..the library
08b0: 20 69 73 20 6e 61 6d 65 64 20 22 6c 69 62 6e 63   is named "libnc
08c0: 75 72 73 65 73 22 20 69 6e 73 74 65 61 64 20 6f  urses" instead o
08d0: 66 20 22 6c 69 62 63 75 72 73 65 73 22 20 67 69  f "libcurses" gi
08e0: 76 65 0a 09 74 68 65 20 22 2d 77 69 74 68 2d 6e  ve..the "-with-n
08f0: 63 75 72 73 65 73 22 20 6f 70 74 69 6f 6e 20 74  curses" option t
0900: 6f 20 63 6f 6e 66 69 67 75 72 65 2e 20 20 41 6c  o configure.  Al
0910: 73 6f 2c 20 69 66 20 54 63 6c 20 6f 72 20 63 75  so, if Tcl or cu
0920: 72 73 65 73 0a 09 61 72 65 20 6e 6f 74 20 69 6e  rses..are not in
0930: 73 74 61 6c 6c 65 64 20 69 6e 20 74 68 65 20 73  stalled in the s
0940: 74 61 6e 64 61 72 64 20 73 65 61 72 63 68 20 70  tandard search p
0950: 61 74 68 2c 20 79 6f 75 20 63 61 6e 20 75 73 65  ath, you can use
0960: 0a 09 22 2d 77 69 74 68 2d 6c 69 62 64 69 72 73  .."-with-libdirs
0970: 3d 22 20 61 6e 64 20 22 2d 77 69 74 68 2d 69 6e  =" and "-with-in
0980: 63 64 69 72 73 3d 22 20 74 6f 20 61 64 64 20 64  cdirs=" to add d
0990: 69 72 65 63 74 6f 72 69 65 73 20 74 6f 0a 09 74  irectories to..t
09a0: 68 65 20 6c 69 62 72 61 72 79 20 61 6e 64 20 68  he library and h
09b0: 65 61 64 65 72 20 73 65 61 72 63 68 20 70 61 74  eader search pat
09c0: 68 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 20  h, respectively 
09d0: 28 75 73 65 20 74 68 65 0a 09 64 69 72 65 63 74  (use the..direct
09e0: 69 76 65 73 20 6f 6e 63 65 2c 20 74 68 65 20 61  ives once, the a
09f0: 72 67 75 6d 65 6e 74 20 63 61 6e 20 62 65 20 61  rgument can be a
0a00: 20 6c 69 73 74 20 6f 66 20 73 70 61 63 65 20 73   list of space s
0a10: 65 70 61 72 61 74 65 64 0a 09 64 69 72 65 63 74  eparated..direct
0a20: 6f 72 69 65 73 29 2e 20 20 46 6f 72 20 6d 6f 72  ories).  For mor
0a30: 65 20 64 65 74 61 69 6c 73 20 6f 6e 20 75 73 69  e details on usi
0a40: 6e 67 20 63 6f 6e 66 69 67 75 72 65 2c 20 63 68  ng configure, ch
0a50: 65 63 6b 20 6f 75 74 0a 09 74 68 65 20 61 75 74  eck out..the aut
0a60: 6f 63 6f 6e 66 20 64 6f 63 75 6d 65 6e 74 61 74  oconf documentat
0a70: 69 6f 6e 20 28 6e 6f 74 20 69 6e 63 6c 75 64 65  ion (not include
0a80: 64 20 68 65 72 65 29 2e 0a 0a 20 20 20 20 28 62  d here)...    (b
0a90: 29 20 54 79 70 65 20 22 6d 61 6b 65 22 2e 20 20  ) Type "make".  
0aa0: 54 68 69 73 20 77 69 6c 6c 20 63 72 65 61 74 65  This will create
0ab0: 20 61 20 6c 69 62 72 61 72 79 20 61 72 63 68 69   a library archi
0ac0: 76 65 20 63 61 6c 6c 65 64 20 22 6c 69 62 63 74  ve called "libct
0ad0: 6b 2e 61 22 0a 09 61 6e 64 20 61 6e 20 69 6e 74  k.a"..and an int
0ae0: 65 72 70 72 65 74 65 72 20 61 70 70 6c 69 63 61  erpreter applica
0af0: 74 69 6f 6e 20 63 61 6c 6c 65 64 20 22 63 77 69  tion called "cwi
0b00: 73 68 22 20 74 68 61 74 20 61 6c 6c 6f 77 73 20  sh" that allows 
0b10: 79 6f 75 20 74 6f 20 74 79 70 65 0a 09 54 63 6c  you to type..Tcl
0b20: 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 74 65 72 61   commands intera
0b30: 63 74 69 76 65 6c 79 20 6f 72 20 65 78 65 63 75  ctively or execu
0b40: 74 65 20 73 63 72 69 70 74 20 66 69 6c 65 73 2e  te script files.
0b50: 0a 0a 20 20 20 20 28 63 29 20 49 66 20 74 68 65  ..    (c) If the
0b60: 20 6d 61 6b 65 20 66 61 69 6c 73 20 74 68 65 6e   make fails then
0b70: 20 79 6f 75 27 6c 6c 20 68 61 76 65 20 74 6f 20   you'll have to 
0b80: 70 65 72 73 6f 6e 61 6c 69 7a 65 20 74 68 65 20  personalize the 
0b90: 4d 61 6b 65 66 69 6c 65 0a 20 20 20 20 20 20 20  Makefile.       
0ba0: 20 66 6f 72 20 79 6f 75 72 20 73 69 74 65 20 6f   for your site o
0bb0: 72 20 70 6f 73 73 69 62 6c 79 20 6d 6f 64 69 66  r possibly modif
0bc0: 79 20 74 68 65 20 64 69 73 74 72 69 62 75 74 69  y the distributi
0bd0: 6f 6e 20 69 6e 20 6f 74 68 65 72 20 77 61 79 73  on in other ways
0be0: 2e 0a 09 46 69 72 73 74 20 63 68 65 63 6b 20 74  ...First check t
0bf0: 68 65 20 66 69 6c 65 20 22 70 6f 72 74 69 6e 67  he file "porting
0c00: 2e 6e 6f 74 65 73 22 20 74 6f 20 73 65 65 20 69  .notes" to see i
0c10: 66 20 74 68 65 72 65 20 61 72 65 20 68 69 6e 74  f there are hint
0c20: 73 0a 09 66 6f 72 20 63 6f 6d 70 69 6c 69 6e 67  s..for compiling
0c30: 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 65 6d 2e   on your system.
0c40: 20 20 49 66 20 79 6f 75 20 6e 65 65 64 20 74 6f    If you need to
0c50: 20 6d 6f 64 69 66 79 20 4d 61 6b 65 66 69 6c 65   modify Makefile
0c60: 2c 0a 09 74 68 65 72 65 20 61 72 65 20 63 6f 6d  ,..there are com
0c70: 6d 65 6e 74 73 20 61 74 20 74 68 65 20 62 65 67  ments at the beg
0c80: 69 6e 6e 69 6e 67 20 6f 66 20 69 74 20 74 68 61  inning of it tha
0c90: 74 20 64 65 73 63 72 69 62 65 20 74 68 65 20 74  t describe the t
0ca0: 68 69 6e 67 73 0a 09 79 6f 75 20 6d 69 67 68 74  hings..you might
0cb0: 20 77 61 6e 74 20 74 6f 20 63 68 61 6e 67 65 20   want to change 
0cc0: 61 6e 64 20 68 6f 77 20 74 6f 20 63 68 61 6e 67  and how to chang
0cd0: 65 20 74 68 65 6d 2e 0a 09 0a 20 20 20 20 28 64  e them....    (d
0ce0: 29 20 54 79 70 65 20 22 6d 61 6b 65 20 69 6e 73  ) Type "make ins
0cf0: 74 61 6c 6c 22 20 74 6f 20 69 6e 73 74 61 6c 6c  tall" to install
0d00: 20 43 54 6b 27 73 20 62 69 6e 61 72 69 65 73 20   CTk's binaries 
0d10: 61 6e 64 20 73 63 72 69 70 74 20 66 69 6c 65 73  and script files
0d20: 20 69 6e 0a 20 20 20 20 20 20 20 20 73 74 61 6e   in.        stan
0d30: 64 61 72 64 20 70 6c 61 63 65 73 2e 20 20 49 6e  dard places.  In
0d40: 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6e   the default con
0d50: 66 69 67 75 72 61 74 69 6f 6e 2c 20 69 6e 66 6f  figuration, info
0d60: 72 6d 61 74 69 6f 6e 20 77 69 6c 6c 0a 09 62 65  rmation will..be
0d70: 20 69 6e 73 74 61 6c 6c 65 64 20 69 6e 20 2f 75   installed in /u
0d80: 73 72 2f 6c 6f 63 61 6c 20 73 6f 20 79 6f 75 27  sr/local so you'
0d90: 6c 6c 20 6e 65 65 64 20 77 72 69 74 65 20 70 65  ll need write pe
0da0: 72 6d 69 73 73 69 6f 6e 20 6f 6e 0a 09 74 68 69  rmission on..thi
0db0: 73 20 64 69 72 65 63 74 6f 72 79 2e 20 20 49 66  s directory.  If
0dc0: 20 79 6f 75 27 64 20 6c 69 6b 65 20 74 6f 20 75   you'd like to u
0dd0: 73 65 20 61 20 64 65 66 61 75 6c 74 20 69 6e 73  se a default ins
0de0: 74 61 6c 6c 61 74 69 6f 6e 0a 09 64 69 72 65 63  tallation..direc
0df0: 74 6f 72 79 2c 20 79 6f 75 20 63 61 6e 20 63 68  tory, you can ch
0e00: 61 6e 67 65 20 74 68 65 20 22 65 78 65 63 5f 70  ange the "exec_p
0e10: 72 65 66 69 78 22 20 61 6e 64 20 22 70 72 65 66  refix" and "pref
0e20: 69 78 22 20 64 65 66 69 6e 69 74 69 6f 6e 73 0a  ix" definitions.
0e30: 09 69 6e 20 74 68 65 20 4d 61 6b 65 66 69 6c 65  .in the Makefile
0e40: 2e 0a 0a 20 20 20 20 28 65 29 20 41 74 20 74 68  ...    (e) At th
0e50: 69 73 20 70 6f 69 6e 74 20 79 6f 75 20 63 61 6e  is point you can
0e60: 20 70 6c 61 79 20 77 69 74 68 20 54 63 6c 20 62   play with Tcl b
0e70: 79 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 22  y invoking the "
0e80: 63 77 69 73 68 22 0a 09 70 72 6f 67 72 61 6d 20  cwish"..program 
0e90: 61 6e 64 20 74 79 70 69 6e 67 20 54 63 6c 20 63  and typing Tcl c
0ea0: 6f 6d 6d 61 6e 64 73 2e 20 20 48 6f 77 65 76 65  ommands.  Howeve
0eb0: 72 2c 20 69 66 20 79 6f 75 20 68 61 76 65 6e 27  r, if you haven'
0ec0: 74 20 69 6e 73 74 61 6c 6c 65 64 0a 09 43 54 6b  t installed..CTk
0ed0: 20 74 68 65 6e 20 79 6f 75 27 6c 6c 20 66 69 72   then you'll fir
0ee0: 73 74 20 6e 65 65 64 20 74 6f 20 73 65 74 20 79  st need to set y
0ef0: 6f 75 72 20 43 54 4b 5f 4c 49 42 52 41 52 59 20  our CTK_LIBRARY 
0f00: 65 6e 76 69 72 6f 6e 6d 65 6e 74 0a 09 76 61 72  environment..var
0f10: 69 61 62 6c 65 20 74 6f 20 68 6f 6c 64 20 74 68  iable to hold th
0f20: 65 20 66 75 6c 6c 20 70 61 74 68 20 6e 61 6d 65  e full path name
0f30: 20 6f 66 20 74 68 65 20 22 6c 69 62 72 61 72 79   of the "library
0f40: 22 20 73 75 62 64 69 72 65 63 74 6f 72 79 2e 0a  " subdirectory..
0f50: 0a 49 20 61 6d 20 69 6e 74 65 72 65 73 74 65 64  .I am interested
0f60: 20 69 6e 20 72 65 63 65 69 76 69 6e 67 20 69 6e   in receiving in
0f70: 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 63 68 61  formation on cha
0f80: 6e 67 65 73 20 72 65 71 75 69 72 65 64 20 74 6f  nges required to
0f90: 0a 62 75 69 6c 64 20 43 54 6b 20 6f 6e 20 79 6f  .build CTk on yo
0fa0: 75 72 20 70 6c 61 74 66 6f 72 6d 2e 0a 0a 34 2e  ur platform...4.
0fb0: 20 54 65 73 74 20 73 75 69 74 65 0a 2d 2d 2d 2d   Test suite.----
0fc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e 65 78 74 20  ---------..Next 
0fd0: 72 65 6c 65 61 73 65 2e 20 20 28 52 65 61 6c 6c  release.  (Reall
0fe0: 79 2e 29 0a 0a 35 2e 20 47 65 74 74 69 6e 67 20  y.)..5. Getting 
0ff0: 73 74 61 72 74 65 64 0a 2d 2d 2d 2d 2d 2d 2d 2d  started.--------
1000: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 74 20 69  ----------..It i
1010: 73 20 6e 6f 77 20 65 61 73 79 20 74 6f 20 72 75  s now easy to ru
1020: 6e 20 63 77 69 73 68 20 69 6e 74 65 72 61 63 74  n cwish interact
1030: 69 76 65 6c 79 2e 20 20 49 66 20 79 6f 75 20 68  ively.  If you h
1040: 61 76 65 20 6e 6f 74 0a 69 6e 73 74 61 6c 6c 65  ave not.installe
1050: 64 20 63 77 69 73 68 20 73 65 74 20 74 68 65 20  d cwish set the 
1060: 43 54 4b 5f 4c 49 42 52 41 52 59 20 65 6e 76 69  CTK_LIBRARY envi
1070: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65  ronment variable
1080: 20 74 6f 0a 74 68 65 20 70 61 74 68 20 6f 66 20   to.the path of 
1090: 74 68 65 20 6c 69 62 72 61 72 79 20 64 69 72 65  the library dire
10a0: 63 74 6f 72 79 2c 20 74 68 65 6e 20 74 72 79 3a  ctory, then try:
10b0: 0a 0a 20 20 20 20 63 77 69 73 68 0a 0a 54 68 69  ..    cwish..Thi
10c0: 73 20 77 69 6c 6c 20 73 74 61 72 74 20 63 77 69  s will start cwi
10d0: 73 68 2c 20 61 6e 64 20 74 68 65 6e 20 70 6f 70  sh, and then pop
10e0: 2d 75 70 20 61 20 63 6f 6d 6d 61 6e 64 20 64 69  -up a command di
10f0: 61 6c 6f 67 20 77 69 6e 64 6f 77 20 77 68 65 72  alog window wher
1100: 65 0a 79 6f 75 20 63 61 6e 20 65 6e 74 65 72 20  e.you can enter 
1110: 54 43 4c 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 59  TCL commands.  Y
1120: 6f 75 20 63 61 6e 20 62 72 69 6e 67 20 75 70 20  ou can bring up 
1130: 74 68 69 73 20 64 69 61 6c 6f 67 20 61 74 20 61  this dialog at a
1140: 6e 79 20 74 69 6d 65 0a 62 79 20 70 72 65 73 73  ny time.by press
1150: 69 6e 67 20 3c 43 6f 6e 74 72 6f 6c 2d 43 3e 2e  ing <Control-C>.
1160: 0a 0a 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 74  ..You can also t
1170: 72 79 20 6f 75 74 20 61 20 73 69 6d 70 6c 65 20  ry out a simple 
1180: 64 65 6d 6f 20 6f 66 20 74 68 65 20 63 77 69 73  demo of the cwis
1190: 68 20 77 69 64 67 65 74 73 20 77 69 74 68 3a 0a  h widgets with:.
11a0: 0a 20 20 20 20 63 77 69 73 68 20 6c 69 62 72 61  .    cwish libra
11b0: 72 79 2f 64 65 6d 6f 73 2f 73 74 75 66 66 0a 0a  ry/demos/stuff..
11c0: 54 68 65 72 65 20 61 72 65 20 6f 74 68 65 72 20  There are other 
11d0: 64 65 6d 6f 73 20 69 6e 20 74 68 65 20 6c 69 62  demos in the lib
11e0: 72 61 72 79 2f 64 65 6d 6f 73 20 64 69 72 65 63  rary/demos direc
11f0: 74 6f 72 79 20 69 6e 63 6c 75 64 69 6e 67 20 61  tory including a
1200: 0a 63 72 75 64 65 20 70 6f 72 74 20 6f 66 20 74  .crude port of t
1210: 68 65 20 54 6b 20 77 69 64 67 65 74 20 64 65 6d  he Tk widget dem
1220: 6f 20 28 77 61 72 6e 69 6e 67 20 69 74 20 69 73  o (warning it is
1230: 20 65 61 73 79 20 66 6f 72 20 74 68 65 20 66 6f   easy for the fo
1240: 63 75 73 0a 74 6f 20 67 65 74 20 6c 6f 73 74 20  cus.to get lost 
1250: 2d 20 69 66 20 73 6f 20 70 72 65 73 73 20 43 74  - if so press Ct
1260: 72 6c 2b 43 20 74 6f 20 67 65 74 20 74 68 65 20  rl+C to get the 
1270: 63 6f 6d 6d 61 6e 64 20 64 69 61 6c 6f 67 20 61  command dialog a
1280: 6e 64 0a 74 79 70 65 20 22 65 78 69 74 22 20 74  nd.type "exit" t
1290: 68 65 72 65 29 2e 0a 0a 4b 65 79 20 62 69 6e 64  here)...Key bind
12a0: 69 6e 67 73 20 61 72 65 20 76 65 72 79 20 6e 65  ings are very ne
12b0: 61 72 6c 79 20 74 68 65 20 73 61 6d 65 20 61 73  arly the same as
12c0: 20 66 6f 72 20 54 6b 20 28 77 68 69 63 68 20 69   for Tk (which i
12d0: 73 20 76 65 72 79 20 6e 65 61 72 6c 79 0a 74 68  s very nearly.th
12e0: 65 20 73 61 6d 65 20 61 73 20 4d 6f 74 69 66 29  e same as Motif)
12f0: 2e 20 20 54 68 69 73 20 6d 61 79 20 62 65 20 75  .  This may be u
1300: 6e 66 61 6d 69 6c 69 61 72 20 74 6f 20 70 65 6f  nfamiliar to peo
1310: 70 6c 65 20 75 73 65 64 20 74 6f 20 63 6f 6d 6d  ple used to comm
1320: 6f 6e 0a 55 6e 69 78 20 63 75 72 73 65 73 20 61  on.Unix curses a
1330: 70 70 6c 69 63 61 74 69 6f 6e 73 20 28 65 6c 6d  pplications (elm
1340: 2c 20 6c 79 6e 78 2c 20 2e 2e 29 2e 20 20 49 20  , lynx, ..).  I 
1350: 64 65 63 69 64 65 64 20 74 6f 20 73 74 69 63 6b  decided to stick
1360: 20 77 69 74 68 20 74 68 65 0a 54 6b 20 62 69 6e   with the.Tk bin
1370: 64 69 6e 67 20 66 6f 72 20 74 77 6f 20 72 65 61  ding for two rea
1380: 73 6f 6e 73 3a 0a 0a 31 29 20 20 4c 65 73 73 20  sons:..1)  Less 
1390: 63 6f 6e 66 75 73 69 6f 6e 20 66 6f 72 20 75 73  confusion for us
13a0: 65 72 73 20 74 68 61 74 20 73 77 69 74 63 68 20  ers that switch 
13b0: 62 65 74 77 65 65 6e 20 54 6b 20 61 6e 64 20 43  between Tk and C
13c0: 54 6b 0a 20 20 20 20 76 65 72 73 69 6f 6e 73 20  Tk.    versions 
13d0: 6f 66 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f  of an applicatio
13e0: 6e 2e 0a 0a 32 29 20 20 45 61 73 69 65 72 20 74  n...2)  Easier t
13f0: 6f 20 69 6e 63 6f 72 70 6f 72 61 74 65 20 75 70  o incorporate up
1400: 64 61 74 65 73 20 66 72 6f 6d 20 54 6b 2e 0a 0a  dates from Tk...
1410: 48 65 72 65 20 69 73 20 61 20 71 75 69 63 6b 20  Here is a quick 
1420: 73 75 6d 6d 61 72 79 20 6f 66 20 74 68 65 20 6b  summary of the k
1430: 65 79 20 62 69 6e 64 69 6e 67 73 20 66 6f 72 20  ey bindings for 
1440: 74 68 6f 73 65 20 75 6e 66 61 6d 69 6c 69 61 72  those unfamiliar
1450: 0a 77 69 74 68 20 4d 6f 74 69 66 20 28 6f 72 20  .with Motif (or 
1460: 4d 69 63 72 6f 73 6f 66 74 20 57 69 6e 64 6f 77  Microsoft Window
1470: 73 29 3a 0a 0a 20 20 20 20 3c 53 70 61 63 65 3e  s):..    <Space>
1480: 20 61 63 74 69 76 61 74 65 73 2f 73 65 6c 65 63   activates/selec
1490: 74 73 20 61 20 77 69 64 67 65 74 0a 20 20 20 20  ts a widget.    
14a0: 3c 54 61 62 3e 20 6d 6f 76 65 73 20 66 6f 63 75  <Tab> moves focu
14b0: 73 20 74 6f 20 6e 65 78 74 20 74 68 65 20 77 69  s to next the wi
14c0: 64 67 65 74 0a 20 20 20 20 3c 53 68 69 66 74 2d  dget.    <Shift-
14d0: 54 61 62 3e 20 6d 6f 76 65 73 20 66 6f 63 75 73  Tab> moves focus
14e0: 20 74 6f 20 74 68 65 20 70 72 69 6f 72 20 77 69   to the prior wi
14f0: 64 67 65 74 0a 20 20 20 20 3c 52 65 74 75 72 6e  dget.    <Return
1500: 3e 20 61 63 74 69 76 61 74 65 73 20 74 68 65 20  > activates the 
1510: 64 65 66 61 75 6c 74 20 62 75 74 74 6f 6e 20 69  default button i
1520: 6e 20 61 20 64 69 61 6c 6f 67 0a 20 20 20 20 41  n a dialog.    A
1530: 72 72 6f 77 20 6b 65 79 73 20 6d 6f 76 65 20 74  rrow keys move t
1540: 68 65 20 63 75 72 73 6f 72 20 77 69 74 68 69 6e  he cursor within
1550: 20 61 20 77 69 64 67 65 74 0a 20 20 20 20 3c 46   a widget.    <F
1560: 31 30 3e 20 6d 6f 76 65 73 20 66 6f 63 75 73 20  10> moves focus 
1570: 74 6f 20 74 68 65 20 66 69 72 73 74 20 6d 65 6e  to the first men
1580: 75 0a 20 20 20 20 3c 45 73 63 61 70 65 3e 20 63  u.    <Escape> c
1590: 6c 6f 73 65 73 20 61 20 6d 65 6e 75 20 77 69 74  loses a menu wit
15a0: 68 6f 75 74 20 6d 61 6b 69 6e 67 20 61 20 73 65  hout making a se
15b0: 6c 65 63 74 69 6f 6e 0a 0a 59 6f 75 72 20 74 65  lection..Your te
15c0: 72 6d 69 6e 61 6c 20 6f 72 20 74 65 72 6d 69 6e  rminal or termin
15d0: 66 6f 20 65 6e 74 72 79 20 6d 61 79 20 6e 6f 74  fo entry may not
15e0: 20 73 75 70 70 6f 72 74 20 61 6c 6c 20 74 68 65   support all the
15f0: 20 6b 65 79 73 20 28 6c 69 6b 65 0a 3c 53 68 69   keys (like.<Shi
1600: 66 74 2d 54 61 62 3e 29 2e 20 20 53 65 65 20 52  ft-Tab>).  See R
1610: 45 41 44 4d 45 2e 54 45 52 4d 20 66 6f 72 20 74  EADME.TERM for t
1620: 69 70 73 20 6f 6e 20 63 6f 6e 66 69 67 75 72 69  ips on configuri
1630: 6e 67 20 74 65 72 6d 69 6e 66 6f 0a 65 6e 74 72  ng terminfo.entr
1640: 69 65 73 20 66 6f 72 20 43 54 6b 2e 0a 0a 36 2e  ies for CTk...6.
1650: 20 53 75 6d 6d 61 72 79 20 6f 66 20 64 69 66 66   Summary of diff
1660: 65 72 65 6e 63 65 73 20 62 65 74 77 65 65 6e 20  erences between 
1670: 43 54 6b 20 34 2e 30 62 31 20 61 6e 64 20 54 6b  CTk 4.0b1 and Tk
1680: 20 34 2e 30 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d   4.0.-----------
1690: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
16a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
16b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54  -------------..T
16c0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d  he following com
16d0: 6d 61 6e 64 73 20 61 72 65 20 6e 6f 74 20 61 76  mands are not av
16e0: 61 69 6c 61 62 6c 65 20 69 6e 20 43 54 6b 3a 0a  ailable in CTk:.
16f0: 0a 20 20 20 20 63 61 6e 76 61 73 0a 20 20 20 20  .    canvas.    
1700: 63 6c 69 70 62 6f 61 72 64 0a 20 20 20 20 6d 65  clipboard.    me
1710: 73 73 61 67 65 0a 20 20 20 20 69 6d 61 67 65 0a  ssage.    image.
1720: 20 20 20 20 73 63 61 6c 65 0a 20 20 20 20 73 65      scale.    se
1730: 6c 65 63 74 69 6f 6e 0a 20 20 20 20 73 65 6e 64  lection.    send
1740: 0a 0a 54 68 65 20 77 6d 20 63 6f 6d 6d 61 6e 64  ..The wm command
1750: 20 69 73 20 73 65 76 65 72 65 6c 79 20 63 72 69   is severely cri
1760: 70 70 6c 65 64 2e 0a 0a 4e 6f 6e 65 20 6f 66 20  ppled...None of 
1770: 74 68 65 20 77 69 64 67 65 74 73 20 73 75 70 70  the widgets supp
1780: 6f 72 74 20 74 68 65 20 73 63 61 6e 20 6d 65 74  ort the scan met
1790: 68 6f 64 2e 0a 0a 54 68 65 20 74 65 78 74 20 77  hod...The text w
17a0: 69 64 67 65 74 20 64 6f 65 73 20 6e 6f 74 20 73  idget does not s
17b0: 75 70 70 6f 72 74 20 74 61 67 20 62 69 6e 64 69  upport tag bindi
17c0: 6e 67 73 3a 20 22 74 65 78 74 20 74 61 67 20 62  ngs: "text tag b
17d0: 69 6e 64 22 2e 0a 0a 54 68 65 20 74 65 78 74 20  ind"...The text 
17e0: 77 69 64 67 65 74 20 64 6f 65 73 20 6e 6f 74 20  widget does not 
17f0: 73 75 70 70 6f 72 74 20 65 6d 62 65 64 64 65 64  support embedded
1800: 20 77 69 6e 64 6f 77 73 20 22 74 65 78 74 20 77   windows "text w
1810: 69 6e 64 6f 77 22 2e 0a 0a 54 68 65 20 2d 74 65  indow"...The -te
1820: 61 72 6f 66 66 20 6f 70 74 69 6f 6e 20 66 6f 72  aroff option for
1830: 20 6d 65 6e 75 20 77 69 64 67 65 74 73 20 63 61   menu widgets ca
1840: 6e 20 63 72 65 61 74 65 20 61 20 74 65 61 72 6f  n create a tearo
1850: 66 66 20 65 6e 74 72 79 2c 0a 62 75 74 20 74 68  ff entry,.but th
1860: 65 20 65 6e 74 72 79 20 64 6f 65 73 6e 27 74 20  e entry doesn't 
1870: 77 6f 72 6b 20 28 61 6e 64 20 49 20 64 6f 6e 27  work (and I don'
1880: 74 20 6b 6e 6f 77 20 69 66 20 74 68 65 72 65 20  t know if there 
1890: 69 73 20 61 6e 79 20 70 6f 69 6e 74 0a 69 6e 20  is any point.in 
18a0: 6d 61 6b 69 6e 67 20 69 74 20 77 6f 72 6b 29 2e  making it work).
18b0: 0a 0a 4d 61 6e 79 20 63 6f 6e 66 69 67 75 72 61  ..Many configura
18c0: 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 28 6c 69  tion options (li
18d0: 6b 65 20 2d 62 61 63 6b 67 72 6f 75 6e 64 20 61  ke -background a
18e0: 6e 64 20 2d 66 6f 72 65 67 72 6f 75 6e 64 29 20  nd -foreground) 
18f0: 63 61 6e 6e 6f 74 0a 62 65 20 6d 6f 64 69 66 69  cannot.be modifi
1900: 65 64 2e 20 20 41 74 74 65 6d 70 74 73 20 74 6f  ed.  Attempts to
1910: 20 73 65 74 20 74 68 65 20 75 6e 73 75 70 70 6f   set the unsuppo
1920: 72 74 65 64 20 6f 70 74 69 6f 6e 73 20 77 69 6c  rted options wil
1930: 6c 20 73 69 6c 65 6e 74 6c 79 0a 62 65 20 69 67  l silently.be ig
1940: 6e 6f 72 65 64 2e 20 20 51 75 65 72 79 69 6e 67  nored.  Querying
1950: 20 74 68 65 20 6f 70 74 69 6f 6e 73 20 77 69 74   the options wit
1960: 68 20 63 67 65 74 20 77 69 6c 6c 20 72 65 74 75  h cget will retu
1970: 72 6e 20 61 20 66 69 78 65 64 0a 3f 72 65 61 73  rn a fixed.?reas
1980: 6f 6e 61 62 6c 65 3f 20 76 61 6c 75 65 2e 20 20  onable? value.  
1990: 54 68 65 20 75 6e 73 75 70 70 6f 72 74 65 64 20  The unsupported 
19a0: 6f 70 74 69 6f 6e 73 20 61 72 65 3a 0a 0a 20 20  options are:..  
19b0: 20 20 2d 61 63 74 69 76 65 62 61 63 6b 67 72 6f    -activebackgro
19c0: 75 6e 64 0a 20 20 20 20 2d 61 63 74 69 76 65 62  und.    -activeb
19d0: 6f 72 64 65 72 77 69 64 74 68 0a 20 20 20 20 2d  orderwidth.    -
19e0: 61 63 74 69 76 65 72 65 6c 69 65 66 0a 20 20 20  activerelief.   
19f0: 20 2d 62 61 63 6b 67 72 6f 75 6e 64 0a 20 20 20   -background.   
1a00: 20 2d 62 67 0a 20 20 20 20 2d 62 69 74 6d 61 70   -bg.    -bitmap
1a10: 0a 20 20 20 20 2d 62 6f 72 64 65 72 77 69 64 74  .    -borderwidt
1a20: 68 20 28 73 75 70 70 6f 72 74 65 64 20 62 79 20  h (supported by 
1a30: 77 69 64 67 65 74 73 2c 20 6e 6f 74 20 62 79 20  widgets, not by 
1a40: 74 65 78 74 20 74 61 67 73 29 0a 20 20 20 20 2d  text tags).    -
1a50: 63 6f 6c 6f 72 6d 61 70 0a 20 20 20 20 2d 63 75  colormap.    -cu
1a60: 72 73 6f 72 0a 20 20 20 20 2d 64 69 73 61 62 6c  rsor.    -disabl
1a70: 65 64 66 6f 72 65 67 72 6f 75 6e 64 0a 20 20 20  edforeground.   
1a80: 20 2d 65 78 70 6f 72 74 73 65 6c 65 63 74 69 6f   -exportselectio
1a90: 6e 0a 20 20 20 20 2d 66 67 0a 20 20 20 20 2d 66  n.    -fg.    -f
1aa0: 6f 6e 74 0a 20 20 20 20 2d 66 6f 72 65 67 72 6f  ont.    -foregro
1ab0: 75 6e 64 0a 20 20 20 20 2d 68 69 67 68 6c 69 67  und.    -highlig
1ac0: 68 74 63 6f 6c 6f 72 0a 20 20 20 20 2d 68 69 67  htcolor.    -hig
1ad0: 68 6c 69 67 68 74 62 61 63 6b 67 72 6f 75 6e 64  hlightbackground
1ae0: 0a 20 20 20 20 2d 68 69 67 68 6c 69 67 68 74 74  .    -highlightt
1af0: 68 69 63 6b 6e 65 73 73 0a 20 20 20 20 2d 69 6d  hickness.    -im
1b00: 61 67 65 0a 20 20 20 20 2d 69 6e 73 65 72 74 62  age.    -insertb
1b10: 61 63 6b 67 72 6f 75 6e 64 0a 20 20 20 20 2d 69  ackground.    -i
1b20: 6e 73 65 72 74 62 6f 72 64 65 72 77 69 64 74 68  nsertborderwidth
1b30: 0a 20 20 20 20 2d 69 6e 73 65 72 74 6f 66 66 74  .    -insertofft
1b40: 69 6d 65 0a 20 20 20 20 2d 69 6e 73 65 72 74 6f  ime.    -inserto
1b50: 6e 74 69 6d 65 0a 20 20 20 20 2d 69 6e 73 65 72  ntime.    -inser
1b60: 74 77 69 64 74 68 0a 20 20 20 20 2d 69 6e 64 69  twidth.    -indi
1b70: 63 61 74 6f 72 6f 6e 0a 20 20 20 20 2d 6a 75 6d  catoron.    -jum
1b80: 70 0a 20 20 20 20 2d 72 65 6c 69 65 66 0a 20 20  p.    -relief.  
1b90: 20 20 2d 72 65 70 65 61 74 64 65 6c 61 79 0a 20    -repeatdelay. 
1ba0: 20 20 20 2d 72 65 70 65 61 74 69 6e 74 65 72 76     -repeatinterv
1bb0: 61 6c 0a 20 20 20 20 2d 73 63 72 65 65 6e 0a 20  al.    -screen. 
1bc0: 20 20 20 2d 73 65 6c 65 63 74 62 61 63 6b 67 72     -selectbackgr
1bd0: 6f 75 6e 64 0a 20 20 20 20 2d 73 65 6c 65 63 74  ound.    -select
1be0: 62 6f 72 64 65 72 77 69 64 74 68 0a 20 20 20 20  borderwidth.    
1bf0: 2d 73 65 6c 65 63 74 63 6f 6c 6f 72 0a 20 20 20  -selectcolor.   
1c00: 20 2d 73 65 6c 65 63 74 66 6f 72 65 67 72 6f 75   -selectforegrou
1c10: 6e 64 0a 20 20 20 20 2d 73 65 6c 65 63 74 69 6d  nd.    -selectim
1c20: 61 67 65 0a 20 20 20 20 2d 73 65 74 67 72 69 64  age.    -setgrid
1c30: 0a 20 20 20 20 2d 74 65 61 72 6f 66 66 0a 20 20  .    -tearoff.  
1c40: 20 20 2d 74 72 6f 75 67 68 63 6f 6c 6f 72 0a 20    -troughcolor. 
1c50: 20 20 20 2d 76 69 73 75 61 6c 0a 0a 41 6e 64 20     -visual..And 
1c60: 61 20 6c 6f 74 20 6d 6f 72 65 20 49 20 66 6f 72  a lot more I for
1c70: 67 6f 74 20 74 6f 20 6d 65 6e 74 69 6f 6e 2e 0a  got to mention..
1c80: 0a 37 2e 20 53 75 70 70 6f 72 74 20 61 6e 64 20  .7. Support and 
1c90: 62 75 67 20 66 69 78 65 73 0a 2d 2d 2d 2d 2d 2d  bug fixes.------
1ca0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1cb0: 2d 2d 0a 0a 53 65 6e 64 20 62 75 67 20 72 65 70  --..Send bug rep
1cc0: 6f 72 74 73 20 61 6e 64 20 73 75 67 67 65 73 74  orts and suggest
1cd0: 69 6f 6e 73 20 66 6f 72 20 69 6d 70 72 6f 76 65  ions for improve
1ce0: 6d 65 6e 74 73 20 74 6f 3a 0a 0a 20 20 20 20 4d  ments to:..    M
1cf0: 61 72 74 69 6e 20 41 6e 64 72 65 77 73 0a 20 20  artin Andrews.  
1d00: 20 20 61 6e 64 72 65 77 6d 40 63 63 66 61 64 6d    andrewm@ccfadm
1d10: 2e 65 65 67 2e 63 63 66 2e 6f 72 67 0a 0a 57 68  .eeg.ccf.org..Wh
1d20: 65 6e 20 72 65 70 6f 72 74 69 6e 67 20 62 75 67  en reporting bug
1d30: 73 2c 20 70 6c 65 61 73 65 20 70 72 6f 76 69 64  s, please provid
1d40: 65 20 61 20 73 68 6f 72 74 20 63 77 69 73 68 20  e a short cwish 
1d50: 73 63 72 69 70 74 20 74 68 61 74 20 49 20 63 61  script that I ca
1d60: 6e 0a 75 73 65 20 74 6f 20 72 65 70 72 6f 64 75  n.use to reprodu
1d70: 63 65 20 74 68 65 20 62 75 67 2e 20 20 4d 61 6b  ce the bug.  Mak
1d80: 65 20 73 75 72 65 20 74 68 61 74 20 74 68 65 20  e sure that the 
1d90: 73 63 72 69 70 74 20 72 75 6e 73 20 77 69 74 68  script runs with
1da0: 20 61 0a 62 61 72 65 2d 62 6f 6e 65 73 20 63 77   a.bare-bones cw
1db0: 69 73 68 20 61 6e 64 20 64 6f 65 73 6e 27 74 20  ish and doesn't 
1dc0: 64 65 70 65 6e 64 20 6f 6e 20 61 6e 79 20 65 78  depend on any ex
1dd0: 74 65 6e 73 69 6f 6e 73 2e 20 20 41 6c 73 6f 2c  tensions.  Also,
1de0: 20 70 6c 65 61 73 65 0a 69 6e 63 6c 75 64 65 20   please.include 
1df0: 74 68 72 65 65 20 61 64 64 69 74 69 6f 6e 61 6c  three additional
1e00: 20 70 69 65 63 65 73 20 6f 66 20 69 6e 66 6f 72   pieces of infor
1e10: 6d 61 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20  mation with the 
1e20: 73 63 72 69 70 74 3a 0a 0a 20 20 20 20 28 61 29  script:..    (a)
1e30: 20 68 6f 77 20 64 6f 20 49 20 75 73 65 20 74 68   how do I use th
1e40: 65 20 73 63 72 69 70 74 20 74 6f 20 6d 61 6b 65  e script to make
1e50: 20 74 68 65 20 70 72 6f 62 6c 65 6d 20 68 61 70   the problem hap
1e60: 70 65 6e 20 28 65 2e 67 2e 0a 09 77 68 61 74 20  pen (e.g...what 
1e70: 6b 65 79 73 20 64 6f 20 79 6f 75 20 70 72 65 73  keys do you pres
1e80: 73 2c 20 69 6e 20 77 68 61 74 20 6f 72 64 65 72  s, in what order
1e90: 29 3f 0a 20 20 20 20 28 62 29 20 77 68 61 74 20  )?.    (b) what 
1ea0: 68 61 70 70 65 6e 73 20 77 68 65 6e 20 79 6f 75  happens when you
1eb0: 20 64 6f 20 74 68 65 73 65 20 74 68 69 6e 67 73   do these things
1ec0: 20 28 70 72 65 73 75 6d 61 62 6c 79 20 74 68 69   (presumably thi
1ed0: 73 20 69 73 0a 20 20 20 20 20 20 20 20 75 6e 64  s is.        und
1ee0: 65 73 69 72 61 62 6c 65 29 3f 0a 20 20 20 20 28  esirable)?.    (
1ef0: 63 29 20 77 68 61 74 20 64 69 64 20 79 6f 75 20  c) what did you 
1f00: 65 78 70 65 63 74 20 74 6f 20 68 61 70 70 65 6e  expect to happen
1f10: 20 69 6e 73 74 65 61 64 3f 0a 0a 46 6f 72 20 67   instead?..For g
1f20: 65 6e 65 72 61 6c 20 70 72 6f 62 6c 65 6d 73 20  eneral problems 
1f30: 77 69 74 68 20 75 73 69 6e 67 20 54 6b 20 6f 72  with using Tk or
1f40: 20 54 63 6c 2c 20 74 72 79 20 70 6f 73 74 69 6e   Tcl, try postin
1f50: 67 20 74 6f 20 74 68 65 0a 63 6f 6d 70 2e 6c 61  g to the.comp.la
1f60: 6e 67 2e 74 63 6c 20 55 73 65 6e 65 74 20 6e 65  ng.tcl Usenet ne
1f70: 77 73 67 72 6f 75 70 2e 0a 0a 38 2e 20 52 65 6c  wsgroup...8. Rel
1f80: 65 61 73 65 20 6f 72 67 61 6e 69 7a 61 74 69 6f  ease organizatio
1f90: 6e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  n.--------------
1fa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 45  -------------..E
1fb0: 61 63 68 20 43 54 6b 20 72 65 6c 65 61 73 65 20  ach CTk release 
1fc0: 69 73 20 69 64 65 6e 74 69 66 69 65 64 20 62 79  is identified by
1fd0: 20 74 77 6f 20 6e 75 6d 62 65 72 73 20 73 65 70   two numbers sep
1fe0: 61 72 61 74 65 64 20 62 79 20 61 20 64 6f 74 2c  arated by a dot,
1ff0: 20 65 2e 67 2e 0a 33 2e 32 20 6f 72 20 33 2e 33   e.g..3.2 or 3.3
2000: 2e 20 20 54 68 65 73 65 20 6e 75 6d 62 65 72 73  .  These numbers
2010: 20 6d 61 74 63 68 20 74 68 65 20 72 65 6c 65 61   match the relea
2020: 73 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65  se number of the
2030: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a 54   corresponding.T
2040: 6b 20 72 65 6c 65 61 73 65 2e 20 20 53 75 66 66  k release.  Suff
2050: 69 78 65 73 20 66 6f 72 20 61 6c 70 68 61 2c 20  ixes for alpha, 
2060: 62 65 74 61 2c 20 61 6e 64 20 70 61 74 63 68 20  beta, and patch 
2070: 72 65 6c 65 61 73 65 73 20 28 61 58 2c 20 62 58  releases (aX, bX
2080: 2c 20 61 6e 64 20 70 58 0a 72 65 73 70 65 63 74  , and pX.respect
2090: 69 76 65 6c 79 29 20 61 72 65 20 6e 75 6d 62 65  ively) are numbe
20a0: 72 65 64 20 69 6e 64 65 70 65 6e 64 65 6e 74 20  red independent 
20b0: 6f 66 20 54 6b 2e 0a                             of Tk..