Hex Artifact Content

Artifact ed546801c60a285b10c83e7ded0fb9be0ad989e6:


0000: 54 68 69 73 20 77 69 6c 6c 20 62 75 69 6c 64 20  This will build 
0010: 61 20 54 63 6c 6b 69 74 20 6e 61 6d 65 64 20 22  a Tclkit named "
0020: 74 63 6c 6b 69 74 2d 3c 76 65 72 73 69 6f 6e 3e  tclkit-<version>
0030: 22 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  "...------------
0040: 2d 2d 2d 0a 55 73 69 6e 67 20 54 68 69 73 20 54  ---.Using This T
0050: 6f 6f 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ool.------------
0060: 2d 2d 2d 0a 55 73 61 67 65 3a 0a 09 6b 69 74 63  ---.Usage:..kitc
0070: 72 65 61 74 6f 72 20 5b 7b 3c 76 65 72 73 69 6f  reator [{<versio
0080: 6e 3e 20 7c 20 63 76 73 5f 3c 63 76 73 54 61 67  n> | cvs_<cvsTag
0090: 3e 20 7c 20 63 6c 65 61 6e 20 7c 20 64 69 73 74  > | clean | dist
00a0: 63 6c 65 61 6e 7d 5d 0a 09 20 20 20 20 20 20 20  clean}]..       
00b0: 20 20 20 20 5b 3c 63 6f 6e 66 69 67 75 72 65 5f      [<configure_
00c0: 6f 70 74 69 6f 6e 73 2e 2e 2e 3e 5d 0a 0a 09 57  options...>]...W
00d0: 68 65 72 65 3a 0a 09 09 76 65 72 73 69 6f 6e 20  here:...version 
00e0: 20 20 20 20 20 20 20 20 20 20 20 69 73 20 61 20             is a 
00f0: 54 63 6c 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62  Tcl version numb
0100: 65 72 20 28 65 2e 67 2e 2c 20 38 2e 34 2e 31 39  er (e.g., 8.4.19
0110: 29 0a 09 09 63 76 73 54 61 67 20 20 20 20 20 20  )...cvsTag      
0120: 20 20 20 20 20 20 20 69 73 20 61 20 43 56 53 20         is a CVS 
0130: 72 65 6c 65 61 73 65 20 74 61 67 20 28 65 2e 67  release tag (e.g
0140: 2e 2c 20 48 45 41 44 29 0a 09 09 63 6f 6e 66 69  ., HEAD)...confi
0150: 67 75 72 65 5f 6f 70 74 69 6f 6e 73 20 20 61 72  gure_options  ar
0160: 65 20 6f 70 74 69 6f 6e 73 20 74 6f 20 70 61 73  e options to pas
0170: 73 20 74 6f 20 73 75 62 6f 72 64 69 6e 61 74 65  s to subordinate
0180: 20 63 6f 6e 66 69 67 75 72 65 0a 09 09 20 20 20   configure...   
0190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
01a0: 73 63 72 69 70 74 73 20 28 65 2e 67 2e 2c 20 2d  scripts (e.g., -
01b0: 2d 65 6e 61 62 6c 65 2d 36 34 62 69 74 29 0a 0a  -enable-64bit)..
01c0: 09 44 65 66 61 75 6c 74 20 69 73 20 74 6f 20 63  .Default is to c
01d0: 72 65 61 74 65 20 61 20 54 63 6c 6b 69 74 20 66  reate a Tclkit f
01e0: 72 6f 6d 20 54 63 6c 20 76 65 72 73 69 6f 6e 20  rom Tcl version 
01f0: 38 2e 34 2e 31 39 0a 0a 45 78 61 6d 70 6c 65 73  8.4.19..Examples
0200: 3a 0a 09 31 2e 20 43 72 65 61 74 65 20 61 20 54  :..1. Create a T
0210: 63 6c 6b 69 74 3a 0a 09 09 61 2e 20 24 20 2e 2f  clkit:...a. $ ./
0220: 6b 69 74 63 72 65 61 74 6f 72 0a 0a 09 32 2e 20  kitcreator...2. 
0230: 43 72 65 61 74 65 20 61 20 54 63 6c 6b 69 74 20  Create a Tclkit 
0240: 66 6f 72 20 54 63 6c 20 38 2e 35 2e 38 3a 0a 09  for Tcl 8.5.8:..
0250: 09 61 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61 74  .a. $ ./kitcreat
0260: 6f 72 20 38 2e 35 2e 38 0a 0a 09 33 2e 20 43 72  or 8.5.8...3. Cr
0270: 65 61 74 65 20 61 20 54 63 6c 6b 69 74 20 66 6f  eate a Tclkit fo
0280: 72 20 54 63 6c 20 66 72 6f 6d 20 43 56 53 20 48  r Tcl from CVS H
0290: 45 41 44 3a 0a 09 09 61 2e 20 24 20 2e 2f 6b 69  EAD:...a. $ ./ki
02a0: 74 63 72 65 61 74 6f 72 20 63 76 73 5f 48 45 41  tcreator cvs_HEA
02b0: 44 0a 0a 09 34 2e 20 43 6f 6d 70 69 6c 65 20 61  D...4. Compile a
02c0: 20 36 34 2d 62 69 74 20 54 63 6c 6b 69 74 3a 0a   64-bit Tclkit:.
02d0: 09 09 61 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61  ..a. $ ./kitcrea
02e0: 74 6f 72 20 2d 2d 65 6e 61 62 6c 65 2d 36 34 62  tor --enable-64b
02f0: 69 74 0a 0a 09 35 2e 20 43 72 6f 73 73 2d 63 6f  it...5. Cross-co
0300: 6d 70 69 6c 65 20 61 20 54 63 6c 6b 69 74 3a 0a  mpile a Tclkit:.
0310: 09 09 61 2e 20 42 6f 6f 74 73 74 72 61 70 20 28  ..a. Bootstrap (
0320: 6f 70 74 69 6f 6e 61 6c 2c 20 79 6f 75 20 63 61  optional, you ca
0330: 6e 20 75 73 65 20 61 6e 20 65 78 69 73 74 69 6e  n use an existin
0340: 67 20 54 63 6c 6b 69 74 29 3a 0a 09 09 09 69 2e  g Tclkit):....i.
0350: 20 20 20 24 20 2e 2f 6b 69 74 63 72 65 61 74 6f     $ ./kitcreato
0360: 72 0a 09 09 09 69 69 2e 20 20 24 20 6d 76 20 74  r....ii.  $ mv t
0370: 63 6c 6b 69 74 2d 38 2e 34 2e 31 39 20 74 63 6c  clkit-8.4.19 tcl
0380: 6b 69 74 2d 6c 6f 63 61 6c 0a 09 09 09 69 69 69  kit-local....iii
0390: 2e 20 24 20 54 43 4c 4b 49 54 3d 22 60 70 77 64  . $ TCLKIT="`pwd
03a0: 60 2f 74 63 6c 6b 69 74 2d 6c 6f 63 61 6c 22 0a  `/tclkit-local".
03b0: 09 09 09 69 76 2e 20 20 24 20 65 78 70 6f 72 74  ...iv.  $ export
03c0: 20 54 43 4c 4b 49 54 0a 09 09 62 2e 20 43 72 6f   TCLKIT...b. Cro
03d0: 73 73 2d 63 6f 6d 70 69 6c 65 3a 0a 09 09 09 69  ss-compile:....i
03e0: 2e 20 20 20 24 20 43 43 3d 6d 69 70 73 65 6c 2d  .   $ CC=mipsel-
03f0: 6c 69 6e 75 78 2d 75 63 6c 69 62 63 2d 67 63 63  linux-uclibc-gcc
0400: 0a 09 09 09 69 69 2e 20 20 24 20 41 52 3d 6d 69  ....ii.  $ AR=mi
0410: 70 73 65 6c 2d 6c 69 6e 75 78 2d 75 63 6c 69 62  psel-linux-uclib
0420: 63 2d 61 72 0a 09 09 09 69 69 69 2e 20 24 20 52  c-ar....iii. $ R
0430: 41 4e 4c 49 42 3d 6d 69 70 73 65 6c 2d 6c 69 6e  ANLIB=mipsel-lin
0440: 75 78 2d 75 63 6c 69 62 63 2d 72 61 6e 6c 69 62  ux-uclibc-ranlib
0450: 0a 09 09 09 69 76 2e 20 20 24 20 65 78 70 6f 72  ....iv.  $ expor
0460: 74 20 43 43 20 41 52 20 52 41 4e 4c 49 42 0a 09  t CC AR RANLIB..
0470: 09 76 2e 20 20 20 24 20 2e 2f 6b 69 74 63 72 65  .v.   $ ./kitcre
0480: 61 74 6f 72 20 2d 2d 68 6f 73 74 3d 6d 69 70 73  ator --host=mips
0490: 65 6c 2d 6c 69 6e 75 78 2d 75 63 6c 69 62 63 0a  el-linux-uclibc.
04a0: 0a 09 36 2e 20 43 6f 6d 70 69 6c 65 20 61 20 36  ..6. Compile a 6
04b0: 34 2d 62 69 74 20 54 63 6c 6b 69 74 20 38 2e 35  4-bit Tclkit 8.5
04c0: 2e 38 20 75 73 69 6e 67 20 53 75 6e 53 74 75 64  .8 using SunStud
04d0: 69 6f 20 31 32 2e 31 20 6f 6e 20 53 6f 6c 61 72  io 12.1 on Solar
04e0: 69 73 2f 78 38 36 3a 0a 09 09 61 2e 20 24 20 43  is/x86:...a. $ C
04f0: 43 3d 27 2f 6f 70 74 2f 73 75 6e 73 74 75 64 69  C='/opt/sunstudi
0500: 6f 31 32 2e 31 2f 62 69 6e 2f 63 63 20 2d 6d 36  o12.1/bin/cc -m6
0510: 34 27 0a 09 09 62 2e 20 24 20 43 58 58 3d 27 2f  4'...b. $ CXX='/
0520: 6f 70 74 2f 73 75 6e 73 74 75 64 69 6f 31 32 2e  opt/sunstudio12.
0530: 31 2f 62 69 6e 2f 43 43 20 2d 6d 36 34 27 0a 09  1/bin/CC -m64'..
0540: 09 63 2e 20 24 20 50 41 54 43 48 3d 27 67 70 61  .c. $ PATCH='gpa
0550: 74 63 68 27 0a 09 09 63 2e 20 24 20 65 78 70 6f  tch'...c. $ expo
0560: 72 74 20 43 43 20 43 58 58 20 50 41 54 43 48 0a  rt CC CXX PATCH.
0570: 09 09 64 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61  ..d. $ ./kitcrea
0580: 74 6f 72 20 38 2e 35 2e 38 20 2d 2d 65 6e 61 62  tor 8.5.8 --enab
0590: 6c 65 2d 36 34 62 69 74 0a 0a 09 37 2e 20 54 6f  le-64bit...7. To
05a0: 20 63 6c 65 61 6e 20 75 70 20 70 6f 73 74 2d 62   clean up post-b
05b0: 75 69 6c 64 3a 0a 09 09 61 2e 20 24 20 2e 2f 6b  uild:...a. $ ./k
05c0: 69 74 63 72 65 61 74 6f 72 20 63 6c 65 61 6e 0a  itcreator clean.
05d0: 0a 45 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72  .Environment var
05e0: 69 61 62 6c 65 73 3a 0a 09 31 2e 20 4d 41 4b 45  iables:..1. MAKE
05f0: 0a 09 09 53 70 65 63 69 66 69 65 73 20 74 68 65  ...Specifies the
0600: 20 74 6f 6f 6c 20 79 6f 75 20 77 69 73 68 20 74   tool you wish t
0610: 6f 20 62 65 20 63 61 6c 6c 65 64 20 74 6f 20 62  o be called to b
0620: 75 69 6c 64 20 74 61 72 67 65 74 73 0a 09 09 66  uild targets...f
0630: 72 6f 6d 20 61 20 4d 61 6b 65 66 69 6c 65 2e 20  rom a Makefile. 
0640: 20 54 68 69 73 20 73 63 72 69 70 74 20 69 73 20   This script is 
0650: 67 65 6e 65 72 61 6c 6c 79 20 6d 6f 72 65 20 77  generally more w
0660: 65 6c 6c 20 74 65 73 74 65 64 0a 09 09 77 69 74  ell tested...wit
0670: 68 20 47 4e 55 20 4d 61 6b 65 2e 0a 0a 09 32 2e  h GNU Make....2.
0680: 20 50 41 54 43 48 0a 09 09 53 70 65 63 69 66 69   PATCH...Specifi
0690: 65 73 20 74 68 65 20 74 6f 6f 6c 20 79 6f 75 20  es the tool you 
06a0: 77 69 73 68 20 74 6f 20 62 65 20 63 61 6c 6c 65  wish to be calle
06b0: 64 20 74 6f 20 61 70 70 6c 79 20 75 6e 69 66 69  d to apply unifi
06c0: 65 64 0a 09 09 64 69 66 66 20 70 61 74 63 68 65  ed...diff patche
06d0: 73 2e 20 20 54 68 69 73 20 73 63 72 69 70 74 20  s.  This script 
06e0: 69 73 20 67 65 6e 65 72 61 6c 6c 79 20 6d 6f 72  is generally mor
06f0: 65 20 77 65 6c 6c 20 74 65 73 74 65 64 20 77 69  e well tested wi
0700: 74 68 0a 09 09 47 4e 55 20 50 61 74 63 68 2e 20  th...GNU Patch. 
0710: 0a 0a 09 33 2e 20 54 43 4c 4b 49 54 0a 09 09 53  ...3. TCLKIT...S
0720: 70 65 63 69 66 79 20 74 68 65 20 70 61 74 68 20  pecify the path 
0730: 74 6f 20 61 20 54 63 6c 6b 69 74 20 74 68 61 74  to a Tclkit that
0740: 20 69 73 20 72 75 6e 6e 61 62 6c 65 20 6f 6e 20   is runnable on 
0750: 74 68 65 20 63 75 72 72 65 6e 74 0a 09 09 73 79  the current...sy
0760: 73 74 65 6d 2e 20 20 54 68 65 20 64 65 66 61 75  stem.  The defau
0770: 6c 74 20 69 73 20 22 74 63 6c 6b 69 74 22 2e 20  lt is "tclkit". 
0780: 20 41 20 77 6f 72 6b 69 6e 67 20 74 63 6c 6b 69   A working tclki
0790: 74 20 69 73 20 72 65 71 75 69 72 65 64 0a 09 09  t is required...
07a0: 66 6f 72 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c  for cross-compil
07b0: 69 6e 67 20 54 63 6c 6b 69 74 73 2e 0a 0a 09 34  ing Tclkits....4
07c0: 2e 20 53 54 41 54 49 43 54 4b 0a 09 09 53 70 65  . STATICTK...Spe
07d0: 63 69 66 79 20 74 68 69 73 20 61 73 20 22 31 22  cify this as "1"
07e0: 20 74 6f 20 73 74 61 74 69 63 61 6c 6c 79 20 6c   to statically l
07f0: 69 6e 6b 20 74 6f 20 54 6b 2e 20 20 54 68 65 20  ink to Tk.  The 
0800: 64 65 66 61 75 6c 74 0a 09 09 61 63 74 69 6f 6e  default...action
0810: 20 6f 6e 20 6d 6f 73 74 20 70 6c 61 74 66 6f 72   on most platfor
0820: 6d 73 20 69 73 20 74 6f 20 64 79 6e 61 6d 69 63  ms is to dynamic
0830: 61 6c 6c 79 20 6c 69 6e 6b 20 74 6f 20 54 6b 2e  ally link to Tk.
0840: 0a 0a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ....------------
0850: 2d 2d 2d 2d 2d 2d 2d 0a 4d 65 74 68 6f 64 20 6f  -------.Method o
0860: 66 20 4f 70 65 72 61 74 69 6f 6e 0a 2d 2d 2d 2d  f Operation.----
0870: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a  ---------------.
0880: 53 75 6d 6d 61 72 79 3a 0a 09 31 2e 20 22 6b 69  Summary:..1. "ki
0890: 74 63 72 65 61 74 6f 72 22 20 63 61 6c 6c 73 20  tcreator" calls 
08a0: 2a 2f 62 75 69 6c 64 2e 73 68 0a 09 32 2e 20 2a  */build.sh..2. *
08b0: 2f 62 75 69 6c 64 2e 73 68 20 64 6f 77 6e 6c 6f  /build.sh downlo
08c0: 61 64 73 20 61 6e 64 20 63 6f 6d 70 69 6c 65 73  ads and compiles
08d0: 20 61 70 70 72 6f 70 72 69 61 74 65 20 73 6f 66   appropriate sof
08e0: 74 77 61 72 65 0a 09 33 2e 20 2a 2f 62 75 69 6c  tware..3. */buil
08f0: 64 2e 73 68 20 69 6e 73 74 61 6c 6c 73 20 73 6f  d.sh installs so
0900: 66 74 77 61 72 65 20 69 6e 74 6f 20 22 69 6e 73  ftware into "ins
0910: 74 22 20 28 72 75 6e 2d 74 69 6d 65 20 2b 20 63  t" (run-time + c
0920: 6f 6d 70 69 6c 65 2d 74 69 6d 65 29 0a 09 34 2e  ompile-time)..4.
0930: 20 2a 2f 62 75 69 6c 64 2e 73 68 20 69 6e 73 74   */build.sh inst
0940: 61 6c 6c 73 20 72 75 6e 2d 74 69 6d 65 20 73 6f  alls run-time so
0950: 66 74 77 61 72 65 20 69 6e 74 6f 20 22 6f 75 74  ftware into "out
0960: 22 2c 20 74 68 69 73 20 77 69 6c 6c 20 62 65 0a  ", this will be.
0970: 09 20 20 20 69 6e 63 6c 75 64 65 64 20 69 6e 20  .   included in 
0980: 74 68 65 20 54 63 6c 6b 69 74 20 61 73 20 69 66  the Tclkit as if
0990: 20 69 74 20 77 65 72 65 20 74 68 65 20 72 6f 6f   it were the roo
09a0: 74 20 64 69 72 65 63 74 6f 72 79 20 6f 66 20 74  t directory of t
09b0: 68 65 0a 09 20 20 20 54 63 6c 6b 69 74 20 28 63  he..   Tclkit (c
09c0: 6f 6d 62 69 6e 65 64 20 77 69 74 68 20 6f 74 68  ombined with oth
09d0: 65 72 20 22 6f 75 74 22 20 64 69 72 65 63 74 6f  er "out" directo
09e0: 72 69 65 73 29 0a 09 35 2e 20 6b 69 74 73 68 2f  ries)..5. kitsh/
09f0: 62 75 69 6c 64 2e 73 68 20 63 6f 6d 70 69 6c 65  build.sh compile
0a00: 73 20 61 20 22 6d 61 69 6e 22 20 66 75 6e 63 74  s a "main" funct
0a10: 69 6f 6e 20 61 6e 64 20 6c 69 6e 6b 73 20 61 6c  ion and links al
0a20: 6c 20 74 68 65 20 62 75 69 6c 74 0a 09 20 20 20  l the built..   
0a30: 6c 69 62 72 61 72 69 65 73 20 74 6f 67 65 74 68  libraries togeth
0a40: 65 72 20 69 6e 74 6f 20 61 6e 20 65 78 65 63 75  er into an execu
0a50: 74 61 62 6c 65 0a 09 36 2e 20 6b 69 74 73 68 2f  table..6. kitsh/
0a60: 62 75 69 6c 64 2e 73 68 20 63 6f 6d 62 69 6e 65  build.sh combine
0a70: 73 20 61 6c 6c 20 74 68 65 20 22 6f 75 74 22 20  s all the "out" 
0a80: 64 69 72 65 63 74 6f 72 69 65 73 20 69 6e 74 6f  directories into
0a90: 20 6f 6e 65 0a 09 37 2e 20 6b 69 74 73 68 2f 62   one..7. kitsh/b
0aa0: 75 69 6c 64 2e 73 68 20 63 72 65 61 74 65 73 20  uild.sh creates 
0ab0: 61 20 4d 65 74 61 6b 69 74 20 64 61 74 61 62 61  a Metakit databa
0ac0: 73 65 20 66 72 6f 6d 20 74 68 65 20 63 6f 6d 62  se from the comb
0ad0: 69 6e 65 64 0a 09 20 20 20 64 69 72 65 63 74 6f  ined..   directo
0ae0: 72 69 65 73 20 61 6e 64 20 61 70 70 65 6e 64 73  ries and appends
0af0: 20 74 68 61 74 20 74 6f 20 74 68 65 20 63 6f 6d   that to the com
0b00: 70 69 6c 65 64 20 65 78 65 63 75 74 61 62 6c 65  piled executable
0b10: 20 75 73 69 6e 67 3a 0a 09 09 61 2e 20 41 20 54   using:...a. A T
0b20: 63 6c 6b 69 74 20 66 6f 75 6e 64 20 69 6e 20 74  clkit found in t
0b30: 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76  he environment v
0b40: 61 72 69 61 62 6c 65 20 22 54 43 4c 4b 49 54 22  ariable "TCLKIT"
0b50: 20 28 74 63 6c 6b 69 74 0a 09 09 20 20 20 69 66   (tclkit...   if
0b60: 20 75 6e 73 65 74 29 20 69 66 20 69 74 20 69 73   unset) if it is
0b70: 20 66 75 6e 63 74 69 6f 6e 61 6c 3b 20 6f 72 0a   functional; or.
0b80: 09 09 62 2e 20 54 68 65 20 62 75 69 6c 74 20 6b  ..b. The built k
0b90: 69 74 20 69 74 73 65 6c 66 20 28 64 6f 65 73 20  it itself (does 
0ba0: 6e 6f 74 20 77 6f 72 6b 20 66 6f 72 20 63 72 6f  not work for cro
0bb0: 73 73 2d 63 6f 6d 70 69 6c 69 6e 67 29 0a 0a 44  ss-compiling)..D
0bc0: 65 74 61 69 6c 73 3a 0a 09 54 68 65 20 67 65 6e  etails:..The gen
0bd0: 65 72 61 6c 20 6d 65 63 68 61 6e 69 73 6d 20 74  eral mechanism t
0be0: 68 61 74 20 65 6e 61 62 6c 65 73 20 61 20 54 63  hat enables a Tc
0bf0: 6c 6b 69 74 20 74 6f 20 6f 70 65 72 61 74 65 20  lkit to operate 
0c00: 69 73 20 61 20 73 6d 61 6c 6c 20 54 63 6c 0a 69  is a small Tcl.i
0c10: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 72 6f  nitialization ro
0c20: 75 74 69 6e 65 20 6c 69 6e 6b 65 64 20 73 74 61  utine linked sta
0c30: 74 69 63 61 6c 6c 79 20 74 6f 20 74 68 65 20 63  tically to the c
0c40: 6f 72 65 20 6c 69 62 72 61 72 69 65 73 20 6e 65  ore libraries ne
0c50: 65 64 65 64 20 74 6f 0a 6f 70 65 72 61 74 65 20  eded to.operate 
0c60: 61 20 54 63 6c 20 69 6e 74 65 72 70 72 65 74 65  a Tcl interprete
0c70: 72 2c 20 74 68 65 20 54 63 6c 20 56 46 53 20 4c  r, the Tcl VFS L
0c80: 61 79 65 72 2c 20 61 6e 64 20 61 20 64 61 74 61  ayer, and a data
0c90: 62 61 73 65 2d 62 61 63 6b 65 64 20 28 4d 65 74  base-backed (Met
0ca0: 61 6b 69 74 29 0a 56 69 72 74 75 61 6c 20 46 69  akit).Virtual Fi
0cb0: 6c 65 20 53 79 73 74 65 6d 20 74 68 61 74 20 69  le System that i
0cc0: 73 20 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68  s appended to th
0cd0: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 65 78 65  e end of the exe
0ce0: 63 75 74 61 62 6c 65 2e 0a 0a 54 68 69 73 20 70  cutable...This p
0cf0: 72 6f 6a 65 63 74 20 62 72 69 6e 67 73 20 74 6f  roject brings to
0d00: 67 65 74 68 65 72 20 61 6c 6c 20 6f 66 20 74 68  gether all of th
0d10: 65 20 72 65 71 75 69 72 65 64 20 70 69 65 63 65  e required piece
0d20: 73 2c 20 70 6c 75 73 20 73 6f 6d 65 20 61 64 64  s, plus some add
0d30: 69 74 69 6f 6e 61 6c 0a 70 69 65 63 65 73 20 74  itional.pieces t
0d40: 68 61 74 20 77 65 72 65 20 66 6f 75 6e 64 20 69  hat were found i
0d50: 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 54  n the original T
0d60: 63 6c 6b 69 74 3a 0a 09 31 2e 20 54 6b 20 28 64  clkit:..1. Tk (d
0d70: 79 6e 61 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b 65  ynamically linke
0d80: 64 29 0a 09 32 2e 20 49 74 63 6c 20 28 64 79 6e  d)..2. Itcl (dyn
0d90: 61 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b 65 64 29  amically linked)
0da0: 0a 0a 54 68 65 73 65 20 73 6f 75 72 63 65 20 63  ..These source c
0db0: 6f 64 65 20 66 6f 72 20 74 68 65 73 65 20 70 69  ode for these pi
0dc0: 65 63 65 73 20 61 72 65 20 64 6f 77 6e 6c 6f 61  eces are downloa
0dd0: 64 65 64 2c 20 63 6f 6d 70 69 6c 65 64 2c 20 61  ded, compiled, a
0de0: 6e 64 20 6c 69 6e 6b 65 64 2c 20 61 6e 64 0a 74  nd linked, and.t
0df0: 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74  he database cont
0e00: 61 69 6e 69 6e 67 20 74 68 65 20 61 70 70 72 6f  aining the appro
0e10: 70 72 69 61 74 65 20 66 69 6c 65 73 79 73 74 65  priate filesyste
0e20: 6d 20 64 61 74 61 20 69 73 20 63 72 65 61 74 65  m data is create
0e30: 64 2e 20 20 57 68 61 74 20 73 65 74 73 0a 74 68  d.  What sets.th
0e40: 69 73 20 70 72 6f 6a 65 63 74 20 61 70 61 72 74  is project apart
0e50: 20 66 72 6f 6d 20 6f 74 68 65 72 20 73 69 6d 69   from other simi
0e60: 6c 61 72 20 70 72 6f 6a 65 63 74 73 20 69 73 20  lar projects is 
0e70: 74 68 61 74 3a 0a 09 31 2e 20 49 74 20 61 74 74  that:..1. It att
0e80: 65 6d 70 74 73 20 74 6f 20 62 65 20 6d 6f 64 75  empts to be modu
0e90: 6c 61 72 3b 0a 09 32 2e 20 49 74 20 73 75 70 70  lar;..2. It supp
0ea0: 6f 72 74 73 20 63 72 6f 73 73 2d 63 6f 6d 70 69  orts cross-compi
0eb0: 6c 69 6e 67 3b 0a 09 33 2e 20 49 74 20 64 6f 77  ling;..3. It dow
0ec0: 6e 6c 6f 61 64 73 20 74 68 65 20 73 6f 75 72 63  nloads the sourc
0ed0: 65 20 66 72 6f 6d 20 74 68 65 69 72 20 6f 72 69  e from their ori
0ee0: 67 69 6e 61 6c 20 72 65 70 6f 73 69 74 6f 72 69  ginal repositori
0ef0: 65 73 3b 0a 09 34 2e 20 49 74 20 61 6c 6c 6f 77  es;..4. It allow
0f00: 73 20 79 6f 75 20 74 6f 20 73 70 65 63 69 66 79  s you to specify
0f10: 20 61 6e 20 61 72 62 69 74 72 61 72 79 20 76 65   an arbitrary ve
0f20: 72 73 69 6f 6e 20 6f 66 20 54 63 6c 20 28 69 6e  rsion of Tcl (in
0f30: 63 6c 75 64 69 6e 67 0a 09 20 20 20 43 56 53 29  cluding..   CVS)
0f40: 3b 20 61 6e 64 0a 09 35 2e 20 49 74 20 75 73 65  ; and..5. It use
0f50: 73 20 47 4e 55 20 41 75 74 6f 63 6f 6e 66 20 73  s GNU Autoconf s
0f60: 63 72 69 70 74 73 20 66 6f 72 20 63 6f 6d 70 69  cripts for compi
0f70: 6c 69 6e 67 20 74 68 65 20 70 61 72 74 20 6f 66  ling the part of
0f80: 20 74 68 65 20 54 63 6c 6b 69 74 0a 09 20 20 20   the Tclkit..   
0f90: 74 68 61 74 20 62 72 69 6e 67 73 20 74 68 65 20  that brings the 
0fa0: 77 68 6f 6c 65 20 74 68 69 6e 67 20 74 6f 67 65  whole thing toge
0fb0: 74 68 65 72 20 28 74 68 65 20 4b 69 74 73 68 29  ther (the Kitsh)
0fc0: 0a 0a 54 6f 20 61 63 63 6f 6d 70 6c 69 73 68 20  ..To accomplish 
0fd0: 74 68 65 73 65 20 67 6f 61 6c 73 20 74 68 65 20  these goals the 
0fe0: 66 6f 6c 6c 6f 77 69 6e 67 20 6d 65 63 68 61 6e  following mechan
0ff0: 69 73 6d 73 20 61 72 65 20 69 6e 20 70 6c 61 63  isms are in plac
1000: 65 3a 0a 09 31 2e 20 54 68 65 20 74 6f 70 2d 6c  e:..1. The top-l
1010: 65 76 65 6c 20 22 6b 69 74 63 72 65 61 74 6f 72  evel "kitcreator
1020: 22 20 73 63 72 69 70 74 3b 20 61 6e 64 0a 09 32  " script; and..2
1030: 2e 20 50 65 72 2d 70 72 6f 6a 65 63 74 20 73 75  . Per-project su
1040: 62 64 69 72 65 63 74 6f 72 69 65 73 2c 20 65 61  bdirectories, ea
1050: 63 68 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20  ch containing a 
1060: 22 62 75 69 6c 64 2e 73 68 22 20 73 63 72 69 70  "build.sh" scrip
1070: 74 0a 0a 54 68 65 20 74 6f 70 2d 6c 65 76 65 6c  t..The top-level
1080: 20 22 6b 69 74 63 72 65 61 74 6f 72 22 20 73 63   "kitcreator" sc
1090: 72 69 70 74 20 69 73 20 76 65 72 79 20 73 69 6d  ript is very sim
10a0: 70 6c 65 2e 20 20 49 74 73 20 6f 6e 6c 79 20 6a  ple.  Its only j
10b0: 6f 62 20 69 73 20 74 6f 0a 69 6e 74 65 72 70 72  ob is to.interpr
10c0: 65 74 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20  et command line 
10d0: 61 72 67 75 6d 65 6e 74 73 2c 20 61 6e 64 20 63  arguments, and c
10e0: 61 6c 6c 20 74 68 65 20 70 65 72 2d 70 72 6f 6a  all the per-proj
10f0: 65 63 74 20 22 62 75 69 6c 64 2e 73 68 22 20 73  ect "build.sh" s
1100: 63 72 69 70 74 73 2e 0a 46 6f 72 20 74 68 65 20  cripts..For the 
1110: 22 74 63 6c 22 20 70 72 6f 6a 65 63 74 20 69 74  "tcl" project it
1120: 20 61 6c 73 6f 20 66 69 6e 64 73 20 74 68 65 20   also finds the 
1130: 61 70 70 72 6f 70 72 69 61 74 65 20 22 74 63 6c  appropriate "tcl
1140: 43 6f 6e 66 69 67 2e 73 68 22 20 28 61 6e 64 20  Config.sh" (and 
1150: 73 74 6f 72 65 73 0a 74 68 69 73 20 70 61 74 68  stores.this path
1160: 20 69 6e 20 54 43 4c 43 4f 4e 46 49 47 44 49 52   in TCLCONFIGDIR
1170: 29 20 74 6f 20 65 6e 61 62 6c 65 20 73 75 62 73  ) to enable subs
1180: 65 71 75 65 6e 74 20 62 75 69 6c 64 20 73 63 72  equent build scr
1190: 69 70 74 73 20 74 6f 20 66 69 6e 64 20 74 68 65  ipts to find the
11a0: 0a 61 70 70 72 6f 70 72 69 61 74 65 20 54 63 6c  .appropriate Tcl
11b0: 20 74 6f 20 6c 69 6e 6b 20 61 67 61 69 6e 73 74   to link against
11c0: 2e 0a 0a 54 68 65 20 70 65 72 2d 70 72 6f 6a 65  ...The per-proje
11d0: 63 74 20 22 62 75 69 6c 64 2e 73 68 22 20 73 63  ct "build.sh" sc
11e0: 72 69 70 74 73 20 61 72 65 20 65 6e 74 69 72 65  ripts are entire
11f0: 6c 79 20 61 75 74 6f 6e 6f 6d 6f 75 73 2e 20 20  ly autonomous.  
1200: 54 68 65 79 20 61 72 65 0a 72 65 73 70 6f 6e 73  They are.respons
1210: 69 62 6c 65 20 66 6f 72 20 64 6f 77 6e 6c 6f 61  ible for downloa
1220: 64 69 6e 67 20 74 68 65 20 73 6f 75 72 63 65 20  ding the source 
1230: 63 6f 64 65 20 66 6f 72 20 74 68 65 20 61 70 70  code for the app
1240: 72 6f 70 72 69 61 74 65 20 76 65 72 73 69 6f 6e  ropriate version
1250: 20 74 68 61 74 0a 77 69 6c 6c 20 63 6f 6d 70 69   that.will compi
1260: 6c 65 20 61 6e 64 20 6c 69 6e 6b 20 61 67 61 69  le and link agai
1270: 6e 73 74 20 74 68 65 20 63 75 72 72 65 6e 74 20  nst the current 
1280: 76 65 72 73 69 6f 6e 20 6f 66 20 54 63 6c 20 28  version of Tcl (
1290: 75 73 65 72 20 72 65 71 75 65 73 74 65 64 0a 76  user requested.v
12a0: 65 72 73 69 6f 6e 20 63 61 6e 20 62 65 20 66 6f  ersion can be fo
12b0: 75 6e 64 20 69 6e 20 22 54 43 4c 56 45 52 53 22  und in "TCLVERS"
12c0: 2c 20 77 68 69 6c 65 20 74 68 65 20 61 63 74 75  , while the actu
12d0: 61 6c 20 76 65 72 73 69 6f 6e 20 6d 75 73 74 20  al version must 
12e0: 62 65 20 72 65 71 75 65 73 74 65 64 0a 66 72 6f  be requested.fro
12f0: 6d 20 74 68 65 20 22 74 63 6c 43 6f 6e 66 69 67  m the "tclConfig
1300: 2e 73 68 22 20 73 63 72 69 70 74 29 2c 20 63 6f  .sh" script), co
1310: 6d 70 69 6c 69 6e 67 20 69 74 2c 20 69 6e 73 74  mpiling it, inst
1320: 61 6c 6c 69 6e 67 20 61 20 66 75 6e 63 74 69 6f  alling a functio
1330: 6e 61 6c 20 63 6f 70 79 0a 69 6e 74 6f 20 74 68  nal copy.into th
1340: 65 20 70 65 72 2d 70 72 6f 6a 65 63 74 20 22 69  e per-project "i
1350: 6e 73 74 22 20 64 69 72 65 63 74 6f 72 79 2c 20  nst" directory, 
1360: 61 6e 64 20 69 6e 73 74 61 6c 6c 69 6e 67 20 61  and installing a
1370: 6e 79 74 68 69 6e 67 20 74 68 61 74 20 6e 65 65  nything that nee
1380: 64 73 20 74 6f 0a 62 65 20 69 6e 20 74 68 65 20  ds to.be in the 
1390: 54 63 6c 6b 69 74 27 73 20 56 46 53 20 72 6f 6f  Tclkit's VFS roo
13a0: 74 20 69 6e 74 6f 20 74 68 65 20 70 65 72 2d 70  t into the per-p
13b0: 72 6f 6a 65 63 74 20 22 6f 75 74 22 20 64 69 72  roject "out" dir
13c0: 65 63 74 6f 72 79 2e 0a 0a 54 68 65 20 65 78 63  ectory...The exc
13d0: 65 70 74 69 6f 6e 20 74 6f 20 74 68 69 73 20 69  eption to this i
13e0: 73 20 74 68 65 20 22 6b 69 74 73 68 22 20 70 72  s the "kitsh" pr
13f0: 6f 6a 65 63 74 2e 20 20 49 74 20 69 73 20 74 68  oject.  It is th
1400: 65 20 67 6c 75 65 20 74 68 61 74 20 62 69 6e 64  e glue that bind
1410: 73 20 61 6c 6c 0a 74 68 65 20 69 6e 64 69 76 69  s all.the indivi
1420: 64 75 61 6c 20 70 72 6f 6a 65 63 74 73 20 74 6f  dual projects to
1430: 67 65 74 68 65 72 20 69 6e 74 6f 20 61 20 73 69  gether into a si
1440: 6e 67 6c 65 20 65 78 65 63 75 74 61 62 6c 65 2e  ngle executable.
1450: 20 20 49 74 73 20 62 75 69 6c 64 20 73 63 72 69    Its build scri
1460: 70 74 0a 64 6f 65 73 20 6e 6f 74 20 63 72 65 61  pt.does not crea
1470: 74 65 20 61 6e 20 22 69 6e 73 74 22 20 6f 72 20  te an "inst" or 
1480: 61 6e 20 22 6f 75 74 22 20 64 69 72 65 63 74 6f  an "out" directo
1490: 72 79 20 62 65 63 61 75 73 65 20 69 74 20 69 73  ry because it is
14a0: 20 6e 6f 74 20 61 20 6c 69 62 72 61 72 79 2e 0a   not a library..
14b0: 49 6e 73 74 65 61 64 2c 20 69 74 20 63 6f 6c 6c  Instead, it coll
14c0: 65 63 74 73 20 61 6c 6c 20 74 68 65 20 6f 74 68  ects all the oth
14d0: 65 72 20 70 72 6f 6a 65 63 74 27 73 20 22 6f 75  er project's "ou
14e0: 74 22 20 64 69 72 65 63 74 6f 72 69 65 73 20 69  t" directories i
14f0: 6e 74 6f 20 61 20 73 69 6e 67 6c 65 0a 64 69 72  nto a single.dir
1500: 65 63 74 6f 72 79 20 28 73 74 61 72 70 61 63 6b  ectory (starpack
1510: 2e 76 66 73 29 2c 20 61 73 20 77 65 6c 6c 20 61  .vfs), as well a
1520: 20 73 74 61 74 69 63 20 66 69 6c 65 20 28 62 6f   static file (bo
1530: 6f 74 2e 74 63 6c 29 2e 20 20 49 74 20 74 68 65  ot.tcl).  It the
1540: 6e 20 63 6f 6d 70 69 6c 65 73 0a 74 68 65 20 73  n compiles.the s
1550: 6f 75 72 63 65 20 63 6f 64 65 2c 20 61 6e 64 20  ource code, and 
1560: 74 68 65 6e 20 69 6e 73 74 61 6c 6c 73 20 74 68  then installs th
1570: 65 20 4d 65 74 61 6b 69 74 20 64 61 74 61 62 61  e Metakit databa
1580: 73 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68  se containing th
1590: 65 20 56 46 53 0a 6f 6e 74 6f 20 74 68 65 20 72  e VFS.onto the r
15a0: 65 73 75 6c 74 69 6e 67 20 65 78 65 63 75 74 61  esulting executa
15b0: 62 6c 65 2e 0a 0a 54 6f 20 63 72 65 61 74 65 20  ble...To create 
15c0: 74 68 65 20 4d 65 74 61 6b 69 74 20 64 61 74 61  the Metakit data
15d0: 62 61 73 65 2c 20 6f 6e 65 20 6f 66 20 74 77 6f  base, one of two
15e0: 20 54 63 6c 6b 69 74 73 20 69 73 20 75 73 65 64   Tclkits is used
15f0: 20 28 74 72 69 65 64 20 69 6e 20 74 68 69 73 0a   (tried in this.
1600: 6f 72 64 65 72 29 3a 0a 09 31 2e 20 54 68 65 20  order):..1. The 
1610: 54 63 6c 6b 69 74 20 73 70 65 63 69 66 69 65 64  Tclkit specified
1620: 20 62 79 20 74 68 65 20 54 43 4c 4b 49 54 20 65   by the TCLKIT e
1630: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61  nvironment varia
1640: 62 6c 65 20 28 6f 72 0a 09 20 20 20 22 74 63 6c  ble (or..   "tcl
1650: 6b 69 74 22 20 69 66 20 74 68 61 74 20 76 61 72  kit" if that var
1660: 69 61 62 6c 65 20 69 73 20 6e 6f 74 20 73 65 74  iable is not set
1670: 29 20 69 66 20 69 74 20 69 73 20 66 75 6e 63 74  ) if it is funct
1680: 69 6f 6e 61 6c 3b 20 6f 72 0a 09 32 2e 20 54 68  ional; or..2. Th
1690: 65 20 62 75 69 6c 74 20 54 63 6c 6b 69 74 20 69  e built Tclkit i
16a0: 74 73 65 6c 66 0a 0a 54 68 65 20 73 65 63 6f 6e  tself..The secon
16b0: 64 20 6d 65 74 68 6f 64 20 77 69 6c 6c 20 6e 6f  d method will no
16c0: 74 20 77 6f 72 6b 20 69 66 20 74 68 65 20 62 75  t work if the bu
16d0: 69 6c 74 20 54 63 6c 6b 69 74 20 69 73 20 6e 6f  ilt Tclkit is no
16e0: 74 20 65 78 65 63 75 74 61 62 6c 65 20 6f 6e 20  t executable on 
16f0: 74 68 65 0a 63 75 72 72 65 6e 74 20 70 6c 61 74  the.current plat
1700: 66 6f 72 6d 20 28 69 2e 65 2e 2c 20 69 6e 20 74  form (i.e., in t
1710: 68 65 20 63 61 73 65 20 6f 66 20 63 72 6f 73 73  he case of cross
1720: 2d 63 6f 6d 70 69 6c 61 74 69 6f 6e 29 20 61 6e  -compilation) an
1730: 64 20 73 6f 20 69 74 20 6d 61 79 20 62 65 0a 6e  d so it may be.n
1740: 65 63 65 73 73 61 72 79 20 74 6f 20 62 6f 6f 74  ecessary to boot
1750: 73 74 72 61 70 20 61 20 72 75 6e 6e 61 62 6c 65  strap a runnable
1760: 20 54 63 6c 6b 69 74 20 66 69 72 73 74 2e 0a      Tclkit first..