Hex Artifact Content

Artifact 0ee71da19fe42491f35dbb339ed4b82a9f7f78a5:


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 43 58 58 3d 66  ....ii.  $ CXX=f
0410: 61 6c 73 65 0a 09 09 09 69 69 69 2e 20 24 20 41  alse....iii. $ A
0420: 52 3d 6d 69 70 73 65 6c 2d 6c 69 6e 75 78 2d 75  R=mipsel-linux-u
0430: 63 6c 69 62 63 2d 61 72 0a 09 09 09 69 76 2e 20  clibc-ar....iv. 
0440: 20 24 20 52 41 4e 4c 49 42 3d 6d 69 70 73 65 6c   $ RANLIB=mipsel
0450: 2d 6c 69 6e 75 78 2d 75 63 6c 69 62 63 2d 72 61  -linux-uclibc-ra
0460: 6e 6c 69 62 0a 09 09 09 76 2e 20 20 20 24 20 65  nlib....v.   $ e
0470: 78 70 6f 72 74 20 43 43 20 43 58 58 20 41 52 20  xport CC CXX AR 
0480: 52 41 4e 4c 49 42 0a 09 09 76 2e 20 20 20 24 20  RANLIB...v.   $ 
0490: 2e 2f 6b 69 74 63 72 65 61 74 6f 72 20 2d 2d 68  ./kitcreator --h
04a0: 6f 73 74 3d 6d 69 70 73 65 6c 2d 6c 69 6e 75 78  ost=mipsel-linux
04b0: 2d 75 63 6c 69 62 63 0a 0a 09 36 2e 20 43 6f 6d  -uclibc...6. Com
04c0: 70 69 6c 65 20 61 20 36 34 2d 62 69 74 20 54 63  pile a 64-bit Tc
04d0: 6c 6b 69 74 20 38 2e 35 2e 38 20 75 73 69 6e 67  lkit 8.5.8 using
04e0: 20 53 75 6e 53 74 75 64 69 6f 20 31 32 2e 31 20   SunStudio 12.1 
04f0: 6f 6e 20 53 6f 6c 61 72 69 73 2f 78 38 36 3a 0a  on Solaris/x86:.
0500: 09 09 61 2e 20 24 20 43 43 3d 27 2f 6f 70 74 2f  ..a. $ CC='/opt/
0510: 73 75 6e 73 74 75 64 69 6f 31 32 2e 31 2f 62 69  sunstudio12.1/bi
0520: 6e 2f 63 63 20 2d 6d 36 34 27 0a 09 09 62 2e 20  n/cc -m64'...b. 
0530: 24 20 43 58 58 3d 27 2f 6f 70 74 2f 73 75 6e 73  $ CXX='/opt/suns
0540: 74 75 64 69 6f 31 32 2e 31 2f 62 69 6e 2f 43 43  tudio12.1/bin/CC
0550: 20 2d 6d 36 34 27 0a 09 09 63 2e 20 24 20 50 41   -m64'...c. $ PA
0560: 54 43 48 3d 27 67 70 61 74 63 68 27 0a 09 09 63  TCH='gpatch'...c
0570: 2e 20 24 20 65 78 70 6f 72 74 20 43 43 20 43 58  . $ export CC CX
0580: 58 20 50 41 54 43 48 0a 09 09 64 2e 20 24 20 2e  X PATCH...d. $ .
0590: 2f 6b 69 74 63 72 65 61 74 6f 72 20 38 2e 35 2e  /kitcreator 8.5.
05a0: 38 20 2d 2d 65 6e 61 62 6c 65 2d 36 34 62 69 74  8 --enable-64bit
05b0: 0a 0a 09 37 2e 20 54 6f 20 63 6c 65 61 6e 20 75  ...7. To clean u
05c0: 70 20 70 6f 73 74 2d 62 75 69 6c 64 3a 0a 09 09  p post-build:...
05d0: 61 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61 74 6f  a. $ ./kitcreato
05e0: 72 20 63 6c 65 61 6e 0a 0a 45 6e 76 69 72 6f 6e  r clean..Environ
05f0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 3a 0a  ment variables:.
0600: 09 31 2e 20 4d 41 4b 45 0a 09 09 53 70 65 63 69  .1. MAKE...Speci
0610: 66 69 65 73 20 74 68 65 20 74 6f 6f 6c 20 79 6f  fies the tool yo
0620: 75 20 77 69 73 68 20 74 6f 20 62 65 20 63 61 6c  u wish to be cal
0630: 6c 65 64 20 74 6f 20 62 75 69 6c 64 20 74 61 72  led to build tar
0640: 67 65 74 73 0a 09 09 66 72 6f 6d 20 61 20 4d 61  gets...from a Ma
0650: 6b 65 66 69 6c 65 2e 20 20 54 68 69 73 20 73 63  kefile.  This sc
0660: 72 69 70 74 20 69 73 20 67 65 6e 65 72 61 6c 6c  ript is generall
0670: 79 20 6d 6f 72 65 20 77 65 6c 6c 20 74 65 73 74  y more well test
0680: 65 64 0a 09 09 77 69 74 68 20 47 4e 55 20 4d 61  ed...with GNU Ma
0690: 6b 65 2e 0a 0a 09 32 2e 20 50 41 54 43 48 0a 09  ke....2. PATCH..
06a0: 09 53 70 65 63 69 66 69 65 73 20 74 68 65 20 74  .Specifies the t
06b0: 6f 6f 6c 20 79 6f 75 20 77 69 73 68 20 74 6f 20  ool you wish to 
06c0: 62 65 20 63 61 6c 6c 65 64 20 74 6f 20 61 70 70  be called to app
06d0: 6c 79 20 75 6e 69 66 69 65 64 0a 09 09 64 69 66  ly unified...dif
06e0: 66 20 70 61 74 63 68 65 73 2e 20 20 54 68 69 73  f patches.  This
06f0: 20 73 63 72 69 70 74 20 69 73 20 67 65 6e 65 72   script is gener
0700: 61 6c 6c 79 20 6d 6f 72 65 20 77 65 6c 6c 20 74  ally more well t
0710: 65 73 74 65 64 20 77 69 74 68 0a 09 09 47 4e 55  ested with...GNU
0720: 20 50 61 74 63 68 2e 20 0a 0a 09 33 2e 20 54 43   Patch. ...3. TC
0730: 4c 4b 49 54 0a 09 09 53 70 65 63 69 66 79 20 74  LKIT...Specify t
0740: 68 65 20 70 61 74 68 20 74 6f 20 61 20 54 63 6c  he path to a Tcl
0750: 6b 69 74 20 74 68 61 74 20 69 73 20 72 75 6e 6e  kit that is runn
0760: 61 62 6c 65 20 6f 6e 20 74 68 65 20 63 75 72 72  able on the curr
0770: 65 6e 74 0a 09 09 73 79 73 74 65 6d 2e 20 20 54  ent...system.  T
0780: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 22 74  he default is "t
0790: 63 6c 6b 69 74 22 2e 20 20 41 20 77 6f 72 6b 69  clkit".  A worki
07a0: 6e 67 20 74 63 6c 6b 69 74 20 69 73 20 72 65 71  ng tclkit is req
07b0: 75 69 72 65 64 0a 09 09 66 6f 72 20 63 72 6f 73  uired...for cros
07c0: 73 2d 63 6f 6d 70 69 6c 69 6e 67 20 54 63 6c 6b  s-compiling Tclk
07d0: 69 74 73 2e 0a 0a 09 34 2e 20 53 54 41 54 49 43  its....4. STATIC
07e0: 54 4b 0a 09 09 53 70 65 63 69 66 79 20 74 68 69  TK...Specify thi
07f0: 73 20 61 73 20 22 31 22 20 74 6f 20 73 74 61 74  s as "1" to stat
0800: 69 63 61 6c 6c 79 20 6c 69 6e 6b 20 74 6f 20 54  ically link to T
0810: 6b 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 0a  k.  The default.
0820: 09 09 61 63 74 69 6f 6e 20 6f 6e 20 6d 6f 73 74  ..action on most
0830: 20 70 6c 61 74 66 6f 72 6d 73 20 69 73 20 74 6f   platforms is to
0840: 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 6c 69 6e   dynamically lin
0850: 6b 20 74 6f 20 54 6b 2e 0a 0a 09 35 2e 20 53 54  k to Tk....5. ST
0860: 52 49 50 0a 09 09 53 70 65 63 69 66 69 65 73 20  RIP...Specifies 
0870: 74 68 65 20 74 6f 6f 6c 20 79 6f 75 20 77 69 73  the tool you wis
0880: 68 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 74  h to be called t
0890: 6f 20 73 74 72 69 70 20 6f 62 6a 65 63 74 20 66  o strip object f
08a0: 69 6c 65 73 2c 0a 09 09 61 72 63 68 69 76 65 73  iles,...archives
08b0: 2c 20 61 6e 64 20 73 68 61 72 65 64 20 6f 62 6a  , and shared obj
08c0: 65 63 74 73 2e 20 20 54 68 65 20 64 65 66 61 75  ects.  The defau
08d0: 6c 74 20 69 73 20 22 73 74 72 69 70 22 2e 20 20  lt is "strip".  
08e0: 59 6f 75 0a 09 09 73 68 6f 75 6c 64 20 70 72 6f  You...should pro
08f0: 62 61 62 6c 79 20 73 65 74 20 74 68 69 73 20 69  bably set this i
0900: 66 20 79 6f 75 20 61 72 65 20 63 72 6f 73 73 2d  f you are cross-
0910: 63 6f 6d 70 69 6c 69 6e 67 2e 0a 0a 09 36 2e 20  compiling....6. 
0920: 4b 49 54 43 52 45 41 54 4f 52 5f 50 4b 47 53 0a  KITCREATOR_PKGS.
0930: 09 09 53 70 65 63 69 66 79 20 77 68 69 63 68 20  ..Specify which 
0940: 6e 6f 6e 2d 72 65 71 75 69 72 65 64 20 70 61 63  non-required pac
0950: 6b 61 67 65 73 20 74 6f 20 62 75 69 6c 64 2e 20  kages to build. 
0960: 20 54 68 65 20 64 65 66 61 75 6c 74 20 6c 69 73   The default lis
0970: 74 0a 09 09 69 73 3a 0a 09 09 09 74 6b 20 69 74  t...is:....tk it
0980: 63 6c 20 6d 6b 34 74 63 6c 0a 09 09 49 66 20 6d  cl mk4tcl...If m
0990: 6b 34 74 63 6c 20 69 73 20 6e 6f 74 20 70 72 65  k4tcl is not pre
09a0: 73 65 6e 74 20 61 20 70 75 72 65 2d 54 63 6c 20  sent a pure-Tcl 
09b0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77  implementation w
09c0: 69 6c 6c 20 62 65 20 75 73 65 64 0a 09 09 69 6e  ill be used...in
09d0: 73 74 65 61 64 2e 0a 0a 09 37 2e 20 4b 49 54 43  stead....7. KITC
09e0: 52 45 41 54 4f 52 5f 41 4c 4c 45 4e 43 4f 44 49  REATOR_ALLENCODI
09f0: 4e 47 53 0a 09 09 53 65 74 20 74 68 69 73 20 76  NGS...Set this v
0a00: 61 72 69 61 62 6c 65 20 74 6f 20 61 20 6e 6f 6e  ariable to a non
0a10: 2d 65 6d 70 74 79 20 73 74 72 69 6e 67 20 74 6f  -empty string to
0a20: 20 67 65 6e 65 72 61 74 65 20 61 20 54 63 6c 6b   generate a Tclk
0a30: 69 74 0a 09 09 77 69 74 68 20 61 6c 6c 20 65 6e  it...with all en
0a40: 63 6f 64 69 6e 67 73 20 72 61 74 68 65 72 20 74  codings rather t
0a50: 68 61 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20  han the default 
0a60: 38 3a 0a 09 09 09 61 73 63 69 69 2e 65 6e 63 20  8:....ascii.enc 
0a70: 63 70 31 32 35 32 2e 65 6e 63 20 69 73 6f 38 38  cp1252.enc iso88
0a80: 35 39 2d 31 2e 65 6e 63 20 69 73 6f 38 38 35 39  59-1.enc iso8859
0a90: 2d 31 35 2e 65 6e 63 0a 09 09 09 69 73 6f 38 38  -15.enc....iso88
0aa0: 35 39 2d 32 2e 65 6e 63 20 6b 6f 69 38 2d 72 2e  59-2.enc koi8-r.
0ab0: 65 6e 63 20 6d 61 63 52 6f 6d 61 6e 2e 65 6e 63  enc macRoman.enc
0ac0: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ..--------------
0ad0: 2d 2d 2d 2d 2d 0a 4d 65 74 68 6f 64 20 6f 66 20  -----.Method of 
0ae0: 4f 70 65 72 61 74 69 6f 6e 0a 2d 2d 2d 2d 2d 2d  Operation.------
0af0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 53 75  -------------.Su
0b00: 6d 6d 61 72 79 3a 0a 09 31 2e 20 22 6b 69 74 63  mmary:..1. "kitc
0b10: 72 65 61 74 6f 72 22 20 63 61 6c 6c 73 20 2a 2f  reator" calls */
0b20: 62 75 69 6c 64 2e 73 68 0a 09 32 2e 20 2a 2f 62  build.sh..2. */b
0b30: 75 69 6c 64 2e 73 68 20 64 6f 77 6e 6c 6f 61 64  uild.sh download
0b40: 73 20 61 6e 64 20 63 6f 6d 70 69 6c 65 73 20 61  s and compiles a
0b50: 70 70 72 6f 70 72 69 61 74 65 20 73 6f 66 74 77  ppropriate softw
0b60: 61 72 65 0a 09 33 2e 20 2a 2f 62 75 69 6c 64 2e  are..3. */build.
0b70: 73 68 20 69 6e 73 74 61 6c 6c 73 20 73 6f 66 74  sh installs soft
0b80: 77 61 72 65 20 69 6e 74 6f 20 22 69 6e 73 74 22  ware into "inst"
0b90: 20 28 72 75 6e 2d 74 69 6d 65 20 2b 20 63 6f 6d   (run-time + com
0ba0: 70 69 6c 65 2d 74 69 6d 65 29 0a 09 34 2e 20 2a  pile-time)..4. *
0bb0: 2f 62 75 69 6c 64 2e 73 68 20 69 6e 73 74 61 6c  /build.sh instal
0bc0: 6c 73 20 72 75 6e 2d 74 69 6d 65 20 73 6f 66 74  ls run-time soft
0bd0: 77 61 72 65 20 69 6e 74 6f 20 22 6f 75 74 22 2c  ware into "out",
0be0: 20 74 68 69 73 20 77 69 6c 6c 20 62 65 0a 09 20   this will be.. 
0bf0: 20 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68    included in th
0c00: 65 20 54 63 6c 6b 69 74 20 61 73 20 69 66 20 69  e Tclkit as if i
0c10: 74 20 77 65 72 65 20 74 68 65 20 72 6f 6f 74 20  t were the root 
0c20: 64 69 72 65 63 74 6f 72 79 20 6f 66 20 74 68 65  directory of the
0c30: 0a 09 20 20 20 54 63 6c 6b 69 74 20 28 63 6f 6d  ..   Tclkit (com
0c40: 62 69 6e 65 64 20 77 69 74 68 20 6f 74 68 65 72  bined with other
0c50: 20 22 6f 75 74 22 20 64 69 72 65 63 74 6f 72 69   "out" directori
0c60: 65 73 29 0a 09 35 2e 20 6b 69 74 73 68 2f 62 75  es)..5. kitsh/bu
0c70: 69 6c 64 2e 73 68 20 63 6f 6d 70 69 6c 65 73 20  ild.sh compiles 
0c80: 61 20 22 6d 61 69 6e 22 20 66 75 6e 63 74 69 6f  a "main" functio
0c90: 6e 20 61 6e 64 20 6c 69 6e 6b 73 20 61 6c 6c 20  n and links all 
0ca0: 74 68 65 20 62 75 69 6c 74 0a 09 20 20 20 6c 69  the built..   li
0cb0: 62 72 61 72 69 65 73 20 74 6f 67 65 74 68 65 72  braries together
0cc0: 20 69 6e 74 6f 20 61 6e 20 65 78 65 63 75 74 61   into an executa
0cd0: 62 6c 65 0a 09 36 2e 20 6b 69 74 73 68 2f 62 75  ble..6. kitsh/bu
0ce0: 69 6c 64 2e 73 68 20 63 6f 6d 62 69 6e 65 73 20  ild.sh combines 
0cf0: 61 6c 6c 20 74 68 65 20 22 6f 75 74 22 20 64 69  all the "out" di
0d00: 72 65 63 74 6f 72 69 65 73 20 69 6e 74 6f 20 6f  rectories into o
0d10: 6e 65 0a 09 37 2e 20 6b 69 74 73 68 2f 62 75 69  ne..7. kitsh/bui
0d20: 6c 64 2e 73 68 20 63 72 65 61 74 65 73 20 61 20  ld.sh creates a 
0d30: 4d 65 74 61 6b 69 74 20 64 61 74 61 62 61 73 65  Metakit database
0d40: 20 66 72 6f 6d 20 74 68 65 20 63 6f 6d 62 69 6e   from the combin
0d50: 65 64 0a 09 20 20 20 64 69 72 65 63 74 6f 72 69  ed..   directori
0d60: 65 73 20 61 6e 64 20 61 70 70 65 6e 64 73 20 74  es and appends t
0d70: 68 61 74 20 74 6f 20 74 68 65 20 63 6f 6d 70 69  hat to the compi
0d80: 6c 65 64 20 65 78 65 63 75 74 61 62 6c 65 20 75  led executable u
0d90: 73 69 6e 67 3a 0a 09 09 61 2e 20 41 20 54 63 6c  sing:...a. A Tcl
0da0: 6b 69 74 20 66 6f 75 6e 64 20 69 6e 20 74 68 65  kit found in the
0db0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
0dc0: 69 61 62 6c 65 20 22 54 43 4c 4b 49 54 22 20 28  iable "TCLKIT" (
0dd0: 74 63 6c 6b 69 74 0a 09 09 20 20 20 69 66 20 75  tclkit...   if u
0de0: 6e 73 65 74 29 20 69 66 20 69 74 20 69 73 20 66  nset) if it is f
0df0: 75 6e 63 74 69 6f 6e 61 6c 3b 20 6f 72 0a 09 09  unctional; or...
0e00: 62 2e 20 54 68 65 20 62 75 69 6c 74 20 6b 69 74  b. The built kit
0e10: 20 69 74 73 65 6c 66 20 28 64 6f 65 73 20 6e 6f   itself (does no
0e20: 74 20 77 6f 72 6b 20 66 6f 72 20 63 72 6f 73 73  t work for cross
0e30: 2d 63 6f 6d 70 69 6c 69 6e 67 29 0a 0a 44 65 74  -compiling)..Det
0e40: 61 69 6c 73 3a 0a 09 54 68 65 20 67 65 6e 65 72  ails:..The gener
0e50: 61 6c 20 6d 65 63 68 61 6e 69 73 6d 20 74 68 61  al mechanism tha
0e60: 74 20 65 6e 61 62 6c 65 73 20 61 20 54 63 6c 6b  t enables a Tclk
0e70: 69 74 20 74 6f 20 6f 70 65 72 61 74 65 20 69 73  it to operate is
0e80: 20 61 20 73 6d 61 6c 6c 20 54 63 6c 0a 69 6e 69   a small Tcl.ini
0e90: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 72 6f 75 74  tialization rout
0ea0: 69 6e 65 20 6c 69 6e 6b 65 64 20 73 74 61 74 69  ine linked stati
0eb0: 63 61 6c 6c 79 20 74 6f 20 74 68 65 20 63 6f 72  cally to the cor
0ec0: 65 20 6c 69 62 72 61 72 69 65 73 20 6e 65 65 64  e libraries need
0ed0: 65 64 20 74 6f 0a 6f 70 65 72 61 74 65 20 61 20  ed to.operate a 
0ee0: 54 63 6c 20 69 6e 74 65 72 70 72 65 74 65 72 2c  Tcl interpreter,
0ef0: 20 74 68 65 20 54 63 6c 20 56 46 53 20 4c 61 79   the Tcl VFS Lay
0f00: 65 72 2c 20 61 6e 64 20 61 20 64 61 74 61 62 61  er, and a databa
0f10: 73 65 2d 62 61 63 6b 65 64 20 28 4d 65 74 61 6b  se-backed (Metak
0f20: 69 74 29 0a 56 69 72 74 75 61 6c 20 46 69 6c 65  it).Virtual File
0f30: 20 53 79 73 74 65 6d 20 74 68 61 74 20 69 73 20   System that is 
0f40: 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20  appended to the 
0f50: 65 6e 64 20 6f 66 20 74 68 65 20 65 78 65 63 75  end of the execu
0f60: 74 61 62 6c 65 2e 0a 0a 54 68 69 73 20 70 72 6f  table...This pro
0f70: 6a 65 63 74 20 62 72 69 6e 67 73 20 74 6f 67 65  ject brings toge
0f80: 74 68 65 72 20 61 6c 6c 20 6f 66 20 74 68 65 20  ther all of the 
0f90: 72 65 71 75 69 72 65 64 20 70 69 65 63 65 73 2c  required pieces,
0fa0: 20 70 6c 75 73 20 73 6f 6d 65 20 61 64 64 69 74   plus some addit
0fb0: 69 6f 6e 61 6c 0a 70 69 65 63 65 73 20 74 68 61  ional.pieces tha
0fc0: 74 20 77 65 72 65 20 66 6f 75 6e 64 20 69 6e 20  t were found in 
0fd0: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 54 63 6c  the original Tcl
0fe0: 6b 69 74 3a 0a 09 31 2e 20 54 6b 20 28 64 79 6e  kit:..1. Tk (dyn
0ff0: 61 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b 65 64 29  amically linked)
1000: 0a 09 32 2e 20 49 74 63 6c 20 28 64 79 6e 61 6d  ..2. Itcl (dynam
1010: 69 63 61 6c 6c 79 20 6c 69 6e 6b 65 64 29 0a 0a  ically linked)..
1020: 54 68 65 73 65 20 73 6f 75 72 63 65 20 63 6f 64  These source cod
1030: 65 20 66 6f 72 20 74 68 65 73 65 20 70 69 65 63  e for these piec
1040: 65 73 20 61 72 65 20 64 6f 77 6e 6c 6f 61 64 65  es are downloade
1050: 64 2c 20 63 6f 6d 70 69 6c 65 64 2c 20 61 6e 64  d, compiled, and
1060: 20 6c 69 6e 6b 65 64 2c 20 61 6e 64 0a 74 68 65   linked, and.the
1070: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74 61 69   database contai
1080: 6e 69 6e 67 20 74 68 65 20 61 70 70 72 6f 70 72  ning the appropr
1090: 69 61 74 65 20 66 69 6c 65 73 79 73 74 65 6d 20  iate filesystem 
10a0: 64 61 74 61 20 69 73 20 63 72 65 61 74 65 64 2e  data is created.
10b0: 20 20 57 68 61 74 20 73 65 74 73 0a 74 68 69 73    What sets.this
10c0: 20 70 72 6f 6a 65 63 74 20 61 70 61 72 74 20 66   project apart f
10d0: 72 6f 6d 20 6f 74 68 65 72 20 73 69 6d 69 6c 61  rom other simila
10e0: 72 20 70 72 6f 6a 65 63 74 73 20 69 73 20 74 68  r projects is th
10f0: 61 74 3a 0a 09 31 2e 20 49 74 20 61 74 74 65 6d  at:..1. It attem
1100: 70 74 73 20 74 6f 20 62 65 20 6d 6f 64 75 6c 61  pts to be modula
1110: 72 3b 0a 09 32 2e 20 49 74 20 73 75 70 70 6f 72  r;..2. It suppor
1120: 74 73 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c 69  ts cross-compili
1130: 6e 67 3b 0a 09 33 2e 20 49 74 20 64 6f 77 6e 6c  ng;..3. It downl
1140: 6f 61 64 73 20 74 68 65 20 73 6f 75 72 63 65 20  oads the source 
1150: 66 72 6f 6d 20 74 68 65 69 72 20 6f 72 69 67 69  from their origi
1160: 6e 61 6c 20 72 65 70 6f 73 69 74 6f 72 69 65 73  nal repositories
1170: 3b 0a 09 34 2e 20 49 74 20 61 6c 6c 6f 77 73 20  ;..4. It allows 
1180: 79 6f 75 20 74 6f 20 73 70 65 63 69 66 79 20 61  you to specify a
1190: 6e 20 61 72 62 69 74 72 61 72 79 20 76 65 72 73  n arbitrary vers
11a0: 69 6f 6e 20 6f 66 20 54 63 6c 20 28 69 6e 63 6c  ion of Tcl (incl
11b0: 75 64 69 6e 67 0a 09 20 20 20 43 56 53 29 3b 20  uding..   CVS); 
11c0: 61 6e 64 0a 09 35 2e 20 49 74 20 75 73 65 73 20  and..5. It uses 
11d0: 47 4e 55 20 41 75 74 6f 63 6f 6e 66 20 73 63 72  GNU Autoconf scr
11e0: 69 70 74 73 20 66 6f 72 20 63 6f 6d 70 69 6c 69  ipts for compili
11f0: 6e 67 20 74 68 65 20 70 61 72 74 20 6f 66 20 74  ng the part of t
1200: 68 65 20 54 63 6c 6b 69 74 0a 09 20 20 20 74 68  he Tclkit..   th
1210: 61 74 20 62 72 69 6e 67 73 20 74 68 65 20 77 68  at brings the wh
1220: 6f 6c 65 20 74 68 69 6e 67 20 74 6f 67 65 74 68  ole thing togeth
1230: 65 72 20 28 74 68 65 20 4b 69 74 73 68 29 0a 0a  er (the Kitsh)..
1240: 54 6f 20 61 63 63 6f 6d 70 6c 69 73 68 20 74 68  To accomplish th
1250: 65 73 65 20 67 6f 61 6c 73 20 74 68 65 20 66 6f  ese goals the fo
1260: 6c 6c 6f 77 69 6e 67 20 6d 65 63 68 61 6e 69 73  llowing mechanis
1270: 6d 73 20 61 72 65 20 69 6e 20 70 6c 61 63 65 3a  ms are in place:
1280: 0a 09 31 2e 20 54 68 65 20 74 6f 70 2d 6c 65 76  ..1. The top-lev
1290: 65 6c 20 22 6b 69 74 63 72 65 61 74 6f 72 22 20  el "kitcreator" 
12a0: 73 63 72 69 70 74 3b 20 61 6e 64 0a 09 32 2e 20  script; and..2. 
12b0: 50 65 72 2d 70 72 6f 6a 65 63 74 20 73 75 62 64  Per-project subd
12c0: 69 72 65 63 74 6f 72 69 65 73 2c 20 65 61 63 68  irectories, each
12d0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 22 62   containing a "b
12e0: 75 69 6c 64 2e 73 68 22 20 73 63 72 69 70 74 0a  uild.sh" script.
12f0: 0a 54 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 22  .The top-level "
1300: 6b 69 74 63 72 65 61 74 6f 72 22 20 73 63 72 69  kitcreator" scri
1310: 70 74 20 69 73 20 76 65 72 79 20 73 69 6d 70 6c  pt is very simpl
1320: 65 2e 20 20 49 74 73 20 6f 6e 6c 79 20 6a 6f 62  e.  Its only job
1330: 20 69 73 20 74 6f 0a 69 6e 74 65 72 70 72 65 74   is to.interpret
1340: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 61 72   command line ar
1350: 67 75 6d 65 6e 74 73 2c 20 61 6e 64 20 63 61 6c  guments, and cal
1360: 6c 20 74 68 65 20 70 65 72 2d 70 72 6f 6a 65 63  l the per-projec
1370: 74 20 22 62 75 69 6c 64 2e 73 68 22 20 73 63 72  t "build.sh" scr
1380: 69 70 74 73 2e 0a 46 6f 72 20 74 68 65 20 22 74  ipts..For the "t
1390: 63 6c 22 20 70 72 6f 6a 65 63 74 20 69 74 20 61  cl" project it a
13a0: 6c 73 6f 20 66 69 6e 64 73 20 74 68 65 20 61 70  lso finds the ap
13b0: 70 72 6f 70 72 69 61 74 65 20 22 74 63 6c 43 6f  propriate "tclCo
13c0: 6e 66 69 67 2e 73 68 22 20 28 61 6e 64 20 73 74  nfig.sh" (and st
13d0: 6f 72 65 73 0a 74 68 69 73 20 70 61 74 68 20 69  ores.this path i
13e0: 6e 20 54 43 4c 43 4f 4e 46 49 47 44 49 52 29 20  n TCLCONFIGDIR) 
13f0: 74 6f 20 65 6e 61 62 6c 65 20 73 75 62 73 65 71  to enable subseq
1400: 75 65 6e 74 20 62 75 69 6c 64 20 73 63 72 69 70  uent build scrip
1410: 74 73 20 74 6f 20 66 69 6e 64 20 74 68 65 0a 61  ts to find the.a
1420: 70 70 72 6f 70 72 69 61 74 65 20 54 63 6c 20 74  ppropriate Tcl t
1430: 6f 20 6c 69 6e 6b 20 61 67 61 69 6e 73 74 2e 0a  o link against..
1440: 0a 54 68 65 20 70 65 72 2d 70 72 6f 6a 65 63 74  .The per-project
1450: 20 22 62 75 69 6c 64 2e 73 68 22 20 73 63 72 69   "build.sh" scri
1460: 70 74 73 20 61 72 65 20 65 6e 74 69 72 65 6c 79  pts are entirely
1470: 20 61 75 74 6f 6e 6f 6d 6f 75 73 2e 20 20 54 68   autonomous.  Th
1480: 65 79 20 61 72 65 0a 72 65 73 70 6f 6e 73 69 62  ey are.responsib
1490: 6c 65 20 66 6f 72 20 64 6f 77 6e 6c 6f 61 64 69  le for downloadi
14a0: 6e 67 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f  ng the source co
14b0: 64 65 20 66 6f 72 20 74 68 65 20 61 70 70 72 6f  de for the appro
14c0: 70 72 69 61 74 65 20 76 65 72 73 69 6f 6e 20 74  priate version t
14d0: 68 61 74 0a 77 69 6c 6c 20 63 6f 6d 70 69 6c 65  hat.will compile
14e0: 20 61 6e 64 20 6c 69 6e 6b 20 61 67 61 69 6e 73   and link agains
14f0: 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 65  t the current ve
1500: 72 73 69 6f 6e 20 6f 66 20 54 63 6c 20 28 75 73  rsion of Tcl (us
1510: 65 72 20 72 65 71 75 65 73 74 65 64 0a 76 65 72  er requested.ver
1520: 73 69 6f 6e 20 63 61 6e 20 62 65 20 66 6f 75 6e  sion can be foun
1530: 64 20 69 6e 20 22 54 43 4c 56 45 52 53 22 2c 20  d in "TCLVERS", 
1540: 77 68 69 6c 65 20 74 68 65 20 61 63 74 75 61 6c  while the actual
1550: 20 76 65 72 73 69 6f 6e 20 6d 75 73 74 20 62 65   version must be
1560: 20 72 65 71 75 65 73 74 65 64 0a 66 72 6f 6d 20   requested.from 
1570: 74 68 65 20 22 74 63 6c 43 6f 6e 66 69 67 2e 73  the "tclConfig.s
1580: 68 22 20 73 63 72 69 70 74 29 2c 20 63 6f 6d 70  h" script), comp
1590: 69 6c 69 6e 67 20 69 74 2c 20 69 6e 73 74 61 6c  iling it, instal
15a0: 6c 69 6e 67 20 61 20 66 75 6e 63 74 69 6f 6e 61  ling a functiona
15b0: 6c 20 63 6f 70 79 0a 69 6e 74 6f 20 74 68 65 20  l copy.into the 
15c0: 70 65 72 2d 70 72 6f 6a 65 63 74 20 22 69 6e 73  per-project "ins
15d0: 74 22 20 64 69 72 65 63 74 6f 72 79 2c 20 61 6e  t" directory, an
15e0: 64 20 69 6e 73 74 61 6c 6c 69 6e 67 20 61 6e 79  d installing any
15f0: 74 68 69 6e 67 20 74 68 61 74 20 6e 65 65 64 73  thing that needs
1600: 20 74 6f 0a 62 65 20 69 6e 20 74 68 65 20 54 63   to.be in the Tc
1610: 6c 6b 69 74 27 73 20 56 46 53 20 72 6f 6f 74 20  lkit's VFS root 
1620: 69 6e 74 6f 20 74 68 65 20 70 65 72 2d 70 72 6f  into the per-pro
1630: 6a 65 63 74 20 22 6f 75 74 22 20 64 69 72 65 63  ject "out" direc
1640: 74 6f 72 79 2e 0a 0a 54 68 65 20 65 78 63 65 70  tory...The excep
1650: 74 69 6f 6e 20 74 6f 20 74 68 69 73 20 69 73 20  tion to this is 
1660: 74 68 65 20 22 6b 69 74 73 68 22 20 70 72 6f 6a  the "kitsh" proj
1670: 65 63 74 2e 20 20 49 74 20 69 73 20 74 68 65 20  ect.  It is the 
1680: 67 6c 75 65 20 74 68 61 74 20 62 69 6e 64 73 20  glue that binds 
1690: 61 6c 6c 0a 74 68 65 20 69 6e 64 69 76 69 64 75  all.the individu
16a0: 61 6c 20 70 72 6f 6a 65 63 74 73 20 74 6f 67 65  al projects toge
16b0: 74 68 65 72 20 69 6e 74 6f 20 61 20 73 69 6e 67  ther into a sing
16c0: 6c 65 20 65 78 65 63 75 74 61 62 6c 65 2e 20 20  le executable.  
16d0: 49 74 73 20 62 75 69 6c 64 20 73 63 72 69 70 74  Its build script
16e0: 0a 64 6f 65 73 20 6e 6f 74 20 63 72 65 61 74 65  .does not create
16f0: 20 61 6e 20 22 69 6e 73 74 22 20 6f 72 20 61 6e   an "inst" or an
1700: 20 22 6f 75 74 22 20 64 69 72 65 63 74 6f 72 79   "out" directory
1710: 20 62 65 63 61 75 73 65 20 69 74 20 69 73 20 6e   because it is n
1720: 6f 74 20 61 20 6c 69 62 72 61 72 79 2e 0a 49 6e  ot a library..In
1730: 73 74 65 61 64 2c 20 69 74 20 63 6f 6c 6c 65 63  stead, it collec
1740: 74 73 20 61 6c 6c 20 74 68 65 20 6f 74 68 65 72  ts all the other
1750: 20 70 72 6f 6a 65 63 74 27 73 20 22 6f 75 74 22   project's "out"
1760: 20 64 69 72 65 63 74 6f 72 69 65 73 20 69 6e 74   directories int
1770: 6f 20 61 20 73 69 6e 67 6c 65 0a 64 69 72 65 63  o a single.direc
1780: 74 6f 72 79 20 28 73 74 61 72 70 61 63 6b 2e 76  tory (starpack.v
1790: 66 73 29 2c 20 61 73 20 77 65 6c 6c 20 61 20 73  fs), as well a s
17a0: 74 61 74 69 63 20 66 69 6c 65 20 28 62 6f 6f 74  tatic file (boot
17b0: 2e 74 63 6c 29 2e 20 20 49 74 20 74 68 65 6e 20  .tcl).  It then 
17c0: 63 6f 6d 70 69 6c 65 73 0a 74 68 65 20 73 6f 75  compiles.the sou
17d0: 72 63 65 20 63 6f 64 65 2c 20 61 6e 64 20 74 68  rce code, and th
17e0: 65 6e 20 69 6e 73 74 61 6c 6c 73 20 74 68 65 20  en installs the 
17f0: 4d 65 74 61 6b 69 74 20 64 61 74 61 62 61 73 65  Metakit database
1800: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20   containing the 
1810: 56 46 53 0a 6f 6e 74 6f 20 74 68 65 20 72 65 73  VFS.onto the res
1820: 75 6c 74 69 6e 67 20 65 78 65 63 75 74 61 62 6c  ulting executabl
1830: 65 2e 0a 0a 54 6f 20 63 72 65 61 74 65 20 74 68  e...To create th
1840: 65 20 4d 65 74 61 6b 69 74 20 64 61 74 61 62 61  e Metakit databa
1850: 73 65 2c 20 6f 6e 65 20 6f 66 20 74 77 6f 20 54  se, one of two T
1860: 63 6c 6b 69 74 73 20 69 73 20 75 73 65 64 20 28  clkits is used (
1870: 74 72 69 65 64 20 69 6e 20 74 68 69 73 0a 6f 72  tried in this.or
1880: 64 65 72 29 3a 0a 09 31 2e 20 54 68 65 20 54 63  der):..1. The Tc
1890: 6c 6b 69 74 20 73 70 65 63 69 66 69 65 64 20 62  lkit specified b
18a0: 79 20 74 68 65 20 54 43 4c 4b 49 54 20 65 6e 76  y the TCLKIT env
18b0: 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c  ironment variabl
18c0: 65 20 28 6f 72 0a 09 20 20 20 22 74 63 6c 6b 69  e (or..   "tclki
18d0: 74 22 20 69 66 20 74 68 61 74 20 76 61 72 69 61  t" if that varia
18e0: 62 6c 65 20 69 73 20 6e 6f 74 20 73 65 74 29 20  ble is not set) 
18f0: 69 66 20 69 74 20 69 73 20 66 75 6e 63 74 69 6f  if it is functio
1900: 6e 61 6c 3b 20 6f 72 0a 09 32 2e 20 54 68 65 20  nal; or..2. The 
1910: 62 75 69 6c 74 20 54 63 6c 6b 69 74 20 69 74 73  built Tclkit its
1920: 65 6c 66 0a 0a 54 68 65 20 73 65 63 6f 6e 64 20  elf..The second 
1930: 6d 65 74 68 6f 64 20 77 69 6c 6c 20 6e 6f 74 20  method will not 
1940: 77 6f 72 6b 20 69 66 20 74 68 65 20 62 75 69 6c  work if the buil
1950: 74 20 54 63 6c 6b 69 74 20 69 73 20 6e 6f 74 20  t Tclkit is not 
1960: 65 78 65 63 75 74 61 62 6c 65 20 6f 6e 20 74 68  executable on th
1970: 65 0a 63 75 72 72 65 6e 74 20 70 6c 61 74 66 6f  e.current platfo
1980: 72 6d 20 28 69 2e 65 2e 2c 20 69 6e 20 74 68 65  rm (i.e., in the
1990: 20 63 61 73 65 20 6f 66 20 63 72 6f 73 73 2d 63   case of cross-c
19a0: 6f 6d 70 69 6c 61 74 69 6f 6e 29 20 61 6e 64 20  ompilation) and 
19b0: 73 6f 20 69 74 20 6d 61 79 20 62 65 0a 6e 65 63  so it may be.nec
19c0: 65 73 73 61 72 79 20 74 6f 20 62 6f 6f 74 73 74  essary to bootst
19d0: 72 61 70 20 61 20 72 75 6e 6e 61 62 6c 65 20 54  rap a runnable T
19e0: 63 6c 6b 69 74 20 66 69 72 73 74 2e 0a           clkit first..