Artifact 723f4f4df1af92bc8df7042863bf9e955ba8aa46:
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 09 38 2e 20 43 72 65 r clean...8. Cre
05f0: 61 74 65 20 61 20 54 63 6c 6b 69 74 20 77 69 74 ate a Tclkit wit
0600: 68 6f 75 74 20 4d 65 74 61 6b 69 74 34 20 73 75 hout Metakit4 su
0610: 70 70 6f 72 74 20 28 66 61 6c 6c 73 20 62 61 63 pport (falls bac
0620: 6b 20 74 6f 20 5a 69 70 20 66 6f 72 20 73 74 6f k to Zip for sto
0630: 72 61 67 65 29 3a 0a 09 09 61 2e 20 4b 49 54 43 rage):...a. KITC
0640: 52 45 41 54 4f 52 5f 50 4b 47 53 3d 27 74 6b 20 REATOR_PKGS='tk
0650: 69 74 63 6c 27 0a 09 09 62 2e 20 65 78 70 6f 72 itcl'...b. expor
0660: 74 20 4b 49 54 43 52 45 41 54 4f 52 5f 50 4b 47 t KITCREATOR_PKG
0670: 53 0a 09 09 63 2e 20 2e 2f 6b 69 74 63 72 65 61 S...c. ./kitcrea
0680: 74 6f 72 0a 0a 09 39 2e 20 43 72 65 61 74 65 20 tor...9. Create
0690: 61 20 54 63 6c 6b 69 74 20 77 69 74 68 20 4d 65 a Tclkit with Me
06a0: 74 61 6b 69 74 34 20 73 75 70 70 6f 72 74 2c 20 takit4 support,
06b0: 62 75 74 20 75 73 69 6e 67 20 5a 69 70 20 66 6f but using Zip fo
06c0: 72 20 73 74 6f 72 61 67 65 3a 0a 09 09 61 2e 20 r storage:...a.
06d0: 24 20 2e 2f 6b 69 74 63 72 65 61 74 6f 72 20 2d $ ./kitcreator -
06e0: 2d 65 6e 61 62 6c 65 2d 6b 69 74 2d 73 74 6f 72 -enable-kit-stor
06f0: 61 67 65 3d 7a 69 70 0a 0a 45 6e 76 69 72 6f 6e age=zip..Environ
0700: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 3a 0a ment variables:.
0710: 09 31 2e 20 4d 41 4b 45 0a 09 09 53 70 65 63 69 .1. MAKE...Speci
0720: 66 69 65 73 20 74 68 65 20 74 6f 6f 6c 20 79 6f fies the tool yo
0730: 75 20 77 69 73 68 20 74 6f 20 62 65 20 63 61 6c u wish to be cal
0740: 6c 65 64 20 74 6f 20 62 75 69 6c 64 20 74 61 72 led to build tar
0750: 67 65 74 73 0a 09 09 66 72 6f 6d 20 61 20 4d 61 gets...from a Ma
0760: 6b 65 66 69 6c 65 2e 20 20 54 68 69 73 20 73 63 kefile. This sc
0770: 72 69 70 74 20 69 73 20 67 65 6e 65 72 61 6c 6c ript is generall
0780: 79 20 6d 6f 72 65 20 77 65 6c 6c 20 74 65 73 74 y more well test
0790: 65 64 0a 09 09 77 69 74 68 20 47 4e 55 20 4d 61 ed...with GNU Ma
07a0: 6b 65 2e 0a 0a 09 32 2e 20 50 41 54 43 48 0a 09 ke....2. PATCH..
07b0: 09 53 70 65 63 69 66 69 65 73 20 74 68 65 20 74 .Specifies the t
07c0: 6f 6f 6c 20 79 6f 75 20 77 69 73 68 20 74 6f 20 ool you wish to
07d0: 62 65 20 63 61 6c 6c 65 64 20 74 6f 20 61 70 70 be called to app
07e0: 6c 79 20 75 6e 69 66 69 65 64 0a 09 09 64 69 66 ly unified...dif
07f0: 66 20 70 61 74 63 68 65 73 2e 20 20 54 68 69 73 f patches. This
0800: 20 73 63 72 69 70 74 20 69 73 20 67 65 6e 65 72 script is gener
0810: 61 6c 6c 79 20 6d 6f 72 65 20 77 65 6c 6c 20 74 ally more well t
0820: 65 73 74 65 64 20 77 69 74 68 0a 09 09 47 4e 55 ested with...GNU
0830: 20 50 61 74 63 68 2e 20 0a 0a 09 33 2e 20 54 43 Patch. ...3. TC
0840: 4c 4b 49 54 0a 09 09 53 70 65 63 69 66 79 20 74 LKIT...Specify t
0850: 68 65 20 70 61 74 68 20 74 6f 20 61 20 54 63 6c he path to a Tcl
0860: 6b 69 74 20 74 68 61 74 20 69 73 20 72 75 6e 6e kit that is runn
0870: 61 62 6c 65 20 6f 6e 20 74 68 65 20 63 75 72 72 able on the curr
0880: 65 6e 74 0a 09 09 73 79 73 74 65 6d 2e 20 20 54 ent...system. T
0890: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 22 74 he default is "t
08a0: 63 6c 6b 69 74 22 2e 20 20 41 20 77 6f 72 6b 69 clkit". A worki
08b0: 6e 67 20 74 63 6c 6b 69 74 20 69 73 20 72 65 71 ng tclkit is req
08c0: 75 69 72 65 64 0a 09 09 66 6f 72 20 63 72 6f 73 uired...for cros
08d0: 73 2d 63 6f 6d 70 69 6c 69 6e 67 20 54 63 6c 6b s-compiling Tclk
08e0: 69 74 73 2e 0a 0a 09 34 2e 20 53 54 41 54 49 43 its....4. STATIC
08f0: 54 4b 0a 09 09 53 70 65 63 69 66 79 20 74 68 69 TK...Specify thi
0900: 73 20 61 73 20 22 31 22 20 74 6f 20 73 74 61 74 s as "1" to stat
0910: 69 63 61 6c 6c 79 20 6c 69 6e 6b 20 74 6f 20 54 ically link to T
0920: 6b 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 0a k. The default.
0930: 09 09 61 63 74 69 6f 6e 20 6f 6e 20 6d 6f 73 74 ..action on most
0940: 20 70 6c 61 74 66 6f 72 6d 73 20 69 73 20 74 6f platforms is to
0950: 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 6c 69 6e dynamically lin
0960: 6b 20 74 6f 20 54 6b 2e 20 20 57 68 65 6e 0a 09 k to Tk. When..
0970: 09 62 75 69 6c 64 69 6e 67 20 4b 69 74 44 4c 4c .building KitDLL
0980: 2c 20 53 54 41 54 49 43 54 4b 20 69 73 20 22 31 , STATICTK is "1
0990: 22 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 49 " by default. I
09a0: 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 0a 09 09 f you want to...
09b0: 65 6e 61 62 6c 65 20 64 79 6e 61 6d 69 63 20 6c enable dynamic l
09c0: 69 6e 6b 69 6e 67 20 6f 66 20 54 6b 20 77 69 74 inking of Tk wit
09d0: 68 20 4b 69 74 44 4c 4c 20 79 6f 75 20 77 69 6c h KitDLL you wil
09e0: 6c 20 68 61 76 65 20 74 6f 0a 09 09 73 70 65 63 l have to...spec
09f0: 69 66 79 20 74 68 69 73 20 61 73 20 22 2d 31 22 ify this as "-1"
0a00: 2e 0a 0a 09 35 2e 20 53 54 52 49 50 0a 09 09 53 ....5. STRIP...S
0a10: 70 65 63 69 66 69 65 73 20 74 68 65 20 74 6f 6f pecifies the too
0a20: 6c 20 79 6f 75 20 77 69 73 68 20 74 6f 20 62 65 l you wish to be
0a30: 20 63 61 6c 6c 65 64 20 74 6f 20 73 74 72 69 70 called to strip
0a40: 20 6f 62 6a 65 63 74 20 66 69 6c 65 73 2c 0a 09 object files,..
0a50: 09 61 72 63 68 69 76 65 73 2c 20 61 6e 64 20 73 .archives, and s
0a60: 68 61 72 65 64 20 6f 62 6a 65 63 74 73 2e 20 20 hared objects.
0a70: 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 22 The default is "
0a80: 73 74 72 69 70 22 2e 20 20 59 6f 75 0a 09 09 73 strip". You...s
0a90: 68 6f 75 6c 64 20 70 72 6f 62 61 62 6c 79 20 73 hould probably s
0aa0: 65 74 20 74 68 69 73 20 69 66 20 79 6f 75 20 61 et this if you a
0ab0: 72 65 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c 69 re cross-compili
0ac0: 6e 67 2e 0a 0a 09 36 2e 20 4b 49 54 43 52 45 41 ng....6. KITCREA
0ad0: 54 4f 52 5f 50 4b 47 53 0a 09 09 53 70 65 63 69 TOR_PKGS...Speci
0ae0: 66 79 20 77 68 69 63 68 20 6e 6f 6e 2d 72 65 71 fy which non-req
0af0: 75 69 72 65 64 20 70 61 63 6b 61 67 65 73 20 74 uired packages t
0b00: 6f 20 62 75 69 6c 64 2e 20 20 54 68 65 20 64 65 o build. The de
0b10: 66 61 75 6c 74 20 6c 69 73 74 0a 09 09 69 73 3a fault list...is:
0b20: 0a 09 09 09 74 6b 20 69 74 63 6c 20 6d 6b 34 74 ....tk itcl mk4t
0b30: 63 6c 0a 0a 09 09 49 66 20 6d 6b 34 74 63 6c 20 cl....If mk4tcl
0b40: 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 20 61 is not present a
0b50: 20 5a 69 70 2d 62 61 73 65 64 20 73 74 6f 72 61 Zip-based stora
0b60: 67 65 20 6d 65 63 68 61 6e 69 73 6d 20 77 69 6c ge mechanism wil
0b70: 6c 20 62 65 0a 09 09 75 73 65 64 20 69 6e 73 74 l be...used inst
0b80: 65 61 64 2e 20 20 54 6f 20 73 70 65 63 69 66 79 ead. To specify
0b90: 20 74 68 61 74 20 74 68 65 20 64 65 66 61 75 6c that the defaul
0ba0: 74 20 62 65 20 75 73 65 64 2c 20 64 6f 20 6e 6f t be used, do no
0bb0: 74 20 73 65 74 0a 09 09 74 68 69 73 20 6f 72 20 t set...this or
0bc0: 73 65 74 20 69 74 20 74 6f 20 74 68 65 20 65 6d set it to the em
0bd0: 70 74 79 20 73 74 72 69 6e 67 2e 20 20 54 6f 20 pty string. To
0be0: 73 70 65 63 69 66 79 20 74 68 61 74 20 6e 6f 0a specify that no.
0bf0: 09 09 6e 6f 6e 2d 72 65 71 75 69 72 65 64 20 70 ..non-required p
0c00: 61 63 6b 61 67 65 73 20 62 65 20 62 75 69 6c 74 ackages be built
0c10: 2c 20 73 65 74 20 69 74 20 74 6f 20 61 20 73 74 , set it to a st
0c20: 72 69 6e 67 20 74 68 61 74 0a 09 09 63 6f 6e 74 ring that...cont
0c30: 61 69 6e 73 20 6f 6e 6c 79 20 77 68 69 74 65 20 ains only white
0c40: 73 70 61 63 65 2e 0a 0a 09 09 49 66 20 22 6b 69 space.....If "ki
0c50: 74 64 6c 6c 22 20 69 73 20 73 70 65 63 69 66 69 tdll" is specifi
0c60: 65 64 20 69 6e 20 74 68 65 20 6c 69 73 74 20 74 ed in the list t
0c70: 68 65 20 74 61 72 67 65 74 20 62 65 63 6f 6d 65 he target become
0c80: 73 20 4b 69 74 44 4c 4c 0a 09 09 61 6e 64 20 6e s KitDLL...and n
0c90: 6f 20 54 63 6c 6b 69 74 20 77 69 6c 6c 20 62 75 o Tclkit will bu
0ca0: 69 6c 74 2c 20 62 75 74 20 69 6e 73 74 65 61 64 ilt, but instead
0cb0: 20 6c 69 62 74 63 6c 6b 69 74 2e 0a 0a 09 37 2e libtclkit....7.
0cc0: 20 4b 49 54 43 52 45 41 54 4f 52 5f 4d 49 4e 45 KITCREATOR_MINE
0cd0: 4e 43 4f 44 49 4e 47 53 0a 09 09 53 65 74 20 74 NCODINGS...Set t
0ce0: 68 69 73 20 76 61 72 69 61 62 6c 65 20 74 6f 20 his variable to
0cf0: 61 20 6e 6f 6e 2d 65 6d 70 74 79 20 73 74 72 69 a non-empty stri
0d00: 6e 67 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61 ng to generate a
0d10: 20 54 63 6c 6b 69 74 0a 09 09 77 69 74 68 6f 75 Tclkit...withou
0d20: 74 20 61 6c 6c 20 65 6e 63 6f 64 69 6e 67 73 2c t all encodings,
0d30: 20 6f 6e 6c 79 20 69 6e 63 6c 75 64 69 6e 67 20 only including
0d40: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 09 the following:..
0d50: 09 09 61 73 63 69 69 2e 65 6e 63 20 63 70 31 32 ..ascii.enc cp12
0d60: 35 32 2e 65 6e 63 20 69 73 6f 38 38 35 39 2d 31 52.enc iso8859-1
0d70: 2e 65 6e 63 20 69 73 6f 38 38 35 39 2d 31 35 2e .enc iso8859-15.
0d80: 65 6e 63 0a 09 09 09 69 73 6f 38 38 35 39 2d 32 enc....iso8859-2
0d90: 2e 65 6e 63 20 6b 6f 69 38 2d 72 2e 65 6e 63 20 .enc koi8-r.enc
0da0: 6d 61 63 52 6f 6d 61 6e 2e 65 6e 63 0a 0a 09 38 macRoman.enc...8
0db0: 2e 20 4b 49 54 43 52 45 41 54 4f 52 5f 4d 49 4e . KITCREATOR_MIN
0dc0: 42 55 49 4c 44 0a 09 09 53 65 74 20 74 68 69 73 BUILD...Set this
0dd0: 20 76 61 72 69 61 62 6c 65 20 74 6f 20 61 20 6e variable to a n
0de0: 6f 6e 2d 65 6d 70 74 79 20 73 74 72 69 6e 67 20 on-empty string
0df0: 74 6f 20 65 78 63 6c 75 64 65 20 75 6e 6e 65 63 to exclude unnec
0e00: 65 73 73 61 72 79 0a 09 09 70 61 63 6b 61 67 65 essary...package
0e10: 73 20 66 72 6f 6d 20 54 63 6c 20 62 75 69 6c 64 s from Tcl build
0e20: 2e 20 20 54 68 69 73 20 65 78 63 6c 75 64 65 73 . This excludes
0e30: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 the following p
0e40: 61 63 6b 61 67 65 73 3a 0a 09 09 09 74 63 6c 74 ackages:....tclt
0e50: 65 73 74 0a 0a 4b 69 74 73 68 20 43 6f 6e 66 69 est..Kitsh Confi
0e60: 67 75 72 65 20 4f 70 74 69 6f 6e 73 3a 0a 09 31 gure Options:..1
0e70: 2e 20 2d 2d 65 6e 61 62 6c 65 2d 6b 69 74 2d 73 . --enable-kit-s
0e80: 74 6f 72 61 67 65 3d 7b 7a 69 70 7c 6d 6b 34 7c torage={zip|mk4|
0e90: 61 75 74 6f 7d 0a 09 09 53 70 65 63 69 66 79 20 auto}...Specify
0ea0: 77 68 69 63 68 20 74 79 70 65 20 6f 66 20 73 74 which type of st
0eb0: 6f 72 61 67 65 20 74 6f 20 75 73 65 20 77 69 74 orage to use wit
0ec0: 68 20 74 68 65 20 54 63 6c 6b 69 74 2e 20 20 54 h the Tclkit. T
0ed0: 68 65 0a 09 09 64 65 66 61 75 6c 74 20 69 73 20 he...default is
0ee0: 74 6f 20 61 75 74 6f 2d 64 65 74 65 63 74 2e 20 to auto-detect.
0ef0: 20 41 75 74 6f 2d 64 65 74 65 63 74 69 6f 6e 20 Auto-detection
0f00: 75 73 65 73 20 4d 6b 34 20 69 66 0a 09 09 61 76 uses Mk4 if...av
0f10: 61 69 6c 61 62 6c 65 2c 20 6f 74 68 65 72 77 69 ailable, otherwi
0f20: 73 65 20 69 74 20 66 61 6c 6c 73 20 62 61 63 6b se it falls back
0f30: 20 74 6f 20 5a 69 70 2e 0a 0a 2d 2d 2d 2d 2d 2d to Zip...------
0f40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 4d 65 -------------.Me
0f50: 74 68 6f 64 20 6f 66 20 4f 70 65 72 61 74 69 6f thod of Operatio
0f60: 6e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d n.--------------
0f70: 2d 2d 2d 2d 2d 0a 53 75 6d 6d 61 72 79 3a 0a 09 -----.Summary:..
0f80: 31 2e 20 22 6b 69 74 63 72 65 61 74 6f 72 22 20 1. "kitcreator"
0f90: 63 61 6c 6c 73 20 2a 2f 62 75 69 6c 64 2e 73 68 calls */build.sh
0fa0: 0a 09 32 2e 20 2a 2f 62 75 69 6c 64 2e 73 68 20 ..2. */build.sh
0fb0: 64 6f 77 6e 6c 6f 61 64 73 20 61 6e 64 20 63 6f downloads and co
0fc0: 6d 70 69 6c 65 73 20 61 70 70 72 6f 70 72 69 61 mpiles appropria
0fd0: 74 65 20 73 6f 66 74 77 61 72 65 0a 09 33 2e 20 te software..3.
0fe0: 2a 2f 62 75 69 6c 64 2e 73 68 20 69 6e 73 74 61 */build.sh insta
0ff0: 6c 6c 73 20 73 6f 66 74 77 61 72 65 20 69 6e 74 lls software int
1000: 6f 20 22 69 6e 73 74 22 20 28 72 75 6e 2d 74 69 o "inst" (run-ti
1010: 6d 65 20 2b 20 63 6f 6d 70 69 6c 65 2d 74 69 6d me + compile-tim
1020: 65 29 0a 09 34 2e 20 2a 2f 62 75 69 6c 64 2e 73 e)..4. */build.s
1030: 68 20 69 6e 73 74 61 6c 6c 73 20 72 75 6e 2d 74 h installs run-t
1040: 69 6d 65 20 73 6f 66 74 77 61 72 65 20 69 6e 74 ime software int
1050: 6f 20 22 6f 75 74 22 2c 20 74 68 69 73 20 77 69 o "out", this wi
1060: 6c 6c 20 62 65 0a 09 20 20 20 69 6e 63 6c 75 64 ll be.. includ
1070: 65 64 20 69 6e 20 74 68 65 20 54 63 6c 6b 69 74 ed in the Tclkit
1080: 20 61 73 20 69 66 20 69 74 20 77 65 72 65 20 74 as if it were t
1090: 68 65 20 72 6f 6f 74 20 64 69 72 65 63 74 6f 72 he root director
10a0: 79 20 6f 66 20 74 68 65 0a 09 20 20 20 54 63 6c y of the.. Tcl
10b0: 6b 69 74 20 28 63 6f 6d 62 69 6e 65 64 20 77 69 kit (combined wi
10c0: 74 68 20 6f 74 68 65 72 20 22 6f 75 74 22 20 64 th other "out" d
10d0: 69 72 65 63 74 6f 72 69 65 73 29 0a 09 35 2e 20 irectories)..5.
10e0: 6b 69 74 73 68 2f 62 75 69 6c 64 2e 73 68 20 63 kitsh/build.sh c
10f0: 6f 6d 70 69 6c 65 73 20 61 20 22 6d 61 69 6e 22 ompiles a "main"
1100: 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 20 6c 69 function and li
1110: 6e 6b 73 20 61 6c 6c 20 74 68 65 20 62 75 69 6c nks all the buil
1120: 74 0a 09 20 20 20 6c 69 62 72 61 72 69 65 73 20 t.. libraries
1130: 74 6f 67 65 74 68 65 72 20 69 6e 74 6f 20 61 6e together into an
1140: 20 65 78 65 63 75 74 61 62 6c 65 0a 09 36 2e 20 executable..6.
1150: 6b 69 74 73 68 2f 62 75 69 6c 64 2e 73 68 20 63 kitsh/build.sh c
1160: 6f 6d 62 69 6e 65 73 20 61 6c 6c 20 74 68 65 20 ombines all the
1170: 22 6f 75 74 22 20 64 69 72 65 63 74 6f 72 69 65 "out" directorie
1180: 73 20 69 6e 74 6f 20 6f 6e 65 0a 09 37 2e 20 6b s into one..7. k
1190: 69 74 73 68 2f 62 75 69 6c 64 2e 73 68 20 63 72 itsh/build.sh cr
11a0: 65 61 74 65 73 20 61 20 4d 65 74 61 6b 69 74 20 eates a Metakit
11b0: 6f 72 20 5a 69 70 20 64 61 74 61 62 61 73 65 20 or Zip database
11c0: 66 72 6f 6d 20 74 68 65 20 63 6f 6d 62 69 6e 65 from the combine
11d0: 64 0a 09 20 20 20 64 69 72 65 63 74 6f 72 69 65 d.. directorie
11e0: 73 20 61 6e 64 20 61 70 70 65 6e 64 73 20 74 68 s and appends th
11f0: 61 74 20 74 6f 20 74 68 65 20 63 6f 6d 70 69 6c at to the compil
1200: 65 64 20 65 78 65 63 75 74 61 62 6c 65 20 75 73 ed executable us
1210: 69 6e 67 3a 0a 09 09 61 2e 20 41 20 54 63 6c 6b ing:...a. A Tclk
1220: 69 74 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 it found in the
1230: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 environment vari
1240: 61 62 6c 65 20 22 54 43 4c 4b 49 54 22 20 28 74 able "TCLKIT" (t
1250: 63 6c 6b 69 74 0a 09 09 20 20 20 69 66 20 75 6e clkit... if un
1260: 73 65 74 29 20 69 66 20 69 74 20 69 73 20 66 75 set) if it is fu
1270: 6e 63 74 69 6f 6e 61 6c 3b 20 6f 72 0a 09 09 62 nctional; or...b
1280: 2e 20 54 68 65 20 62 75 69 6c 74 20 6b 69 74 20 . The built kit
1290: 69 74 73 65 6c 66 20 28 64 6f 65 73 20 6e 6f 74 itself (does not
12a0: 20 77 6f 72 6b 20 66 6f 72 20 63 72 6f 73 73 2d work for cross-
12b0: 63 6f 6d 70 69 6c 69 6e 67 29 0a 0a 44 65 74 61 compiling)..Deta
12c0: 69 6c 73 3a 0a 09 54 68 65 20 67 65 6e 65 72 61 ils:..The genera
12d0: 6c 20 6d 65 63 68 61 6e 69 73 6d 20 74 68 61 74 l mechanism that
12e0: 20 65 6e 61 62 6c 65 73 20 61 20 54 63 6c 6b 69 enables a Tclki
12f0: 74 20 74 6f 20 6f 70 65 72 61 74 65 20 69 73 20 t to operate is
1300: 61 20 73 6d 61 6c 6c 20 54 63 6c 0a 69 6e 69 74 a small Tcl.init
1310: 69 61 6c 69 7a 61 74 69 6f 6e 20 72 6f 75 74 69 ialization routi
1320: 6e 65 20 6c 69 6e 6b 65 64 20 73 74 61 74 69 63 ne linked static
1330: 61 6c 6c 79 20 74 6f 20 74 68 65 20 63 6f 72 65 ally to the core
1340: 20 6c 69 62 72 61 72 69 65 73 20 6e 65 65 64 65 libraries neede
1350: 64 20 74 6f 0a 6f 70 65 72 61 74 65 20 61 20 54 d to.operate a T
1360: 63 6c 20 69 6e 74 65 72 70 72 65 74 65 72 2c 20 cl interpreter,
1370: 74 68 65 20 54 63 6c 20 56 46 53 20 4c 61 79 65 the Tcl VFS Laye
1380: 72 2c 20 61 6e 64 20 61 20 64 61 74 61 62 61 73 r, and a databas
1390: 65 2d 62 61 63 6b 65 64 20 28 4d 65 74 61 6b 69 e-backed (Metaki
13a0: 74 29 0a 56 69 72 74 75 61 6c 20 46 69 6c 65 20 t).Virtual File
13b0: 53 79 73 74 65 6d 20 74 68 61 74 20 69 73 20 61 System that is a
13c0: 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 65 ppended to the e
13d0: 6e 64 20 6f 66 20 74 68 65 20 65 78 65 63 75 74 nd of the execut
13e0: 61 62 6c 65 2e 0a 0a 54 68 69 73 20 70 72 6f 6a able...This proj
13f0: 65 63 74 20 62 72 69 6e 67 73 20 74 6f 67 65 74 ect brings toget
1400: 68 65 72 20 61 6c 6c 20 6f 66 20 74 68 65 20 72 her all of the r
1410: 65 71 75 69 72 65 64 20 70 69 65 63 65 73 2c 20 equired pieces,
1420: 70 6c 75 73 20 73 6f 6d 65 20 61 64 64 69 74 69 plus some additi
1430: 6f 6e 61 6c 0a 70 69 65 63 65 73 20 74 68 61 74 onal.pieces that
1440: 20 77 65 72 65 20 66 6f 75 6e 64 20 69 6e 20 74 were found in t
1450: 68 65 20 6f 72 69 67 69 6e 61 6c 20 54 63 6c 6b he original Tclk
1460: 69 74 3a 0a 09 31 2e 20 54 6b 20 28 64 79 6e 61 it:..1. Tk (dyna
1470: 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b 65 64 29 0a mically linked).
1480: 09 32 2e 20 49 74 63 6c 20 28 64 79 6e 61 6d 69 .2. Itcl (dynami
1490: 63 61 6c 6c 79 20 6c 69 6e 6b 65 64 29 0a 0a 54 cally linked)..T
14a0: 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 he source code f
14b0: 6f 72 20 74 68 65 73 65 20 70 69 65 63 65 73 20 or these pieces
14c0: 61 72 65 20 64 6f 77 6e 6c 6f 61 64 65 64 2c 20 are downloaded,
14d0: 63 6f 6d 70 69 6c 65 64 2c 20 61 6e 64 20 6c 69 compiled, and li
14e0: 6e 6b 65 64 2c 20 61 6e 64 20 74 68 65 0a 64 61 nked, and the.da
14f0: 74 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 69 6e tabase containin
1500: 67 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 g the appropriat
1510: 65 20 66 69 6c 65 73 79 73 74 65 6d 20 64 61 74 e filesystem dat
1520: 61 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 57 a is created. W
1530: 68 61 74 20 73 65 74 73 0a 74 68 69 73 20 70 72 hat sets.this pr
1540: 6f 6a 65 63 74 20 61 70 61 72 74 20 66 72 6f 6d oject apart from
1550: 20 6f 74 68 65 72 20 73 69 6d 69 6c 61 72 20 70 other similar p
1560: 72 6f 6a 65 63 74 73 20 69 73 20 74 68 61 74 3a rojects is that:
1570: 0a 09 31 2e 20 49 74 20 61 74 74 65 6d 70 74 73 ..1. It attempts
1580: 20 74 6f 20 62 65 20 6d 6f 64 75 6c 61 72 3b 0a to be modular;.
1590: 09 32 2e 20 49 74 20 73 75 70 70 6f 72 74 73 20 .2. It supports
15a0: 63 72 6f 73 73 2d 63 6f 6d 70 69 6c 69 6e 67 3b cross-compiling;
15b0: 0a 09 33 2e 20 49 74 20 64 6f 77 6e 6c 6f 61 64 ..3. It download
15c0: 73 20 74 68 65 20 73 6f 75 72 63 65 20 66 72 6f s the source fro
15d0: 6d 20 74 68 65 69 72 20 6f 72 69 67 69 6e 61 6c m their original
15e0: 20 72 65 70 6f 73 69 74 6f 72 69 65 73 3b 0a 09 repositories;..
15f0: 34 2e 20 49 74 20 61 6c 6c 6f 77 73 20 79 6f 75 4. It allows you
1600: 20 74 6f 20 73 70 65 63 69 66 79 20 61 6e 20 61 to specify an a
1610: 72 62 69 74 72 61 72 79 20 76 65 72 73 69 6f 6e rbitrary version
1620: 20 6f 66 20 54 63 6c 20 28 69 6e 63 6c 75 64 69 of Tcl (includi
1630: 6e 67 0a 09 20 20 20 43 56 53 29 3b 20 61 6e 64 ng.. CVS); and
1640: 0a 09 35 2e 20 49 74 20 75 73 65 73 20 47 4e 55 ..5. It uses GNU
1650: 20 41 75 74 6f 63 6f 6e 66 20 73 63 72 69 70 74 Autoconf script
1660: 73 20 66 6f 72 20 63 6f 6d 70 69 6c 69 6e 67 20 s for compiling
1670: 74 68 65 20 70 61 72 74 20 6f 66 20 74 68 65 20 the part of the
1680: 54 63 6c 6b 69 74 0a 09 20 20 20 74 68 61 74 20 Tclkit.. that
1690: 62 72 69 6e 67 73 20 74 68 65 20 77 68 6f 6c 65 brings the whole
16a0: 20 74 68 69 6e 67 20 74 6f 67 65 74 68 65 72 20 thing together
16b0: 28 74 68 65 20 4b 69 74 73 68 29 0a 0a 54 6f 20 (the Kitsh)..To
16c0: 61 63 63 6f 6d 70 6c 69 73 68 20 74 68 65 73 65 accomplish these
16d0: 20 67 6f 61 6c 73 20 74 68 65 20 66 6f 6c 6c 6f goals the follo
16e0: 77 69 6e 67 20 6d 65 63 68 61 6e 69 73 6d 73 20 wing mechanisms
16f0: 61 72 65 20 69 6e 20 70 6c 61 63 65 3a 0a 09 31 are in place:..1
1700: 2e 20 54 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 . The top-level
1710: 22 6b 69 74 63 72 65 61 74 6f 72 22 20 73 63 72 "kitcreator" scr
1720: 69 70 74 3b 20 61 6e 64 0a 09 32 2e 20 50 65 72 ipt; and..2. Per
1730: 2d 70 72 6f 6a 65 63 74 20 73 75 62 64 69 72 65 -project subdire
1740: 63 74 6f 72 69 65 73 2c 20 65 61 63 68 20 63 6f ctories, each co
1750: 6e 74 61 69 6e 69 6e 67 20 61 20 22 62 75 69 6c ntaining a "buil
1760: 64 2e 73 68 22 20 73 63 72 69 70 74 0a 0a 54 68 d.sh" script..Th
1770: 65 20 74 6f 70 2d 6c 65 76 65 6c 20 22 6b 69 74 e top-level "kit
1780: 63 72 65 61 74 6f 72 22 20 73 63 72 69 70 74 20 creator" script
1790: 69 73 20 76 65 72 79 20 73 69 6d 70 6c 65 2e 20 is very simple.
17a0: 20 49 74 73 20 6f 6e 6c 79 20 6a 6f 62 20 69 73 Its only job is
17b0: 20 74 6f 0a 69 6e 74 65 72 70 72 65 74 20 63 6f to.interpret co
17c0: 6d 6d 61 6e 64 20 6c 69 6e 65 20 61 72 67 75 6d mmand line argum
17d0: 65 6e 74 73 2c 20 61 6e 64 20 63 61 6c 6c 20 74 ents, and call t
17e0: 68 65 20 70 65 72 2d 70 72 6f 6a 65 63 74 20 22 he per-project "
17f0: 62 75 69 6c 64 2e 73 68 22 20 73 63 72 69 70 74 build.sh" script
1800: 73 2e 0a 46 6f 72 20 74 68 65 20 22 74 63 6c 22 s..For the "tcl"
1810: 20 70 72 6f 6a 65 63 74 20 69 74 20 61 6c 73 6f project it also
1820: 20 66 69 6e 64 73 20 74 68 65 20 61 70 70 72 6f finds the appro
1830: 70 72 69 61 74 65 20 22 74 63 6c 43 6f 6e 66 69 priate "tclConfi
1840: 67 2e 73 68 22 20 28 61 6e 64 20 73 74 6f 72 65 g.sh" (and store
1850: 73 0a 74 68 69 73 20 70 61 74 68 20 69 6e 20 54 s.this path in T
1860: 43 4c 43 4f 4e 46 49 47 44 49 52 29 20 74 6f 20 CLCONFIGDIR) to
1870: 65 6e 61 62 6c 65 20 73 75 62 73 65 71 75 65 6e enable subsequen
1880: 74 20 62 75 69 6c 64 20 73 63 72 69 70 74 73 20 t build scripts
1890: 74 6f 20 66 69 6e 64 20 74 68 65 0a 61 70 70 72 to find the.appr
18a0: 6f 70 72 69 61 74 65 20 54 63 6c 20 74 6f 20 6c opriate Tcl to l
18b0: 69 6e 6b 20 61 67 61 69 6e 73 74 2e 0a 0a 54 68 ink against...Th
18c0: 65 20 70 65 72 2d 70 72 6f 6a 65 63 74 20 22 62 e per-project "b
18d0: 75 69 6c 64 2e 73 68 22 20 73 63 72 69 70 74 73 uild.sh" scripts
18e0: 20 61 72 65 20 65 6e 74 69 72 65 6c 79 20 61 75 are entirely au
18f0: 74 6f 6e 6f 6d 6f 75 73 2e 20 20 54 68 65 79 20 tonomous. They
1900: 61 72 65 0a 72 65 73 70 6f 6e 73 69 62 6c 65 20 are.responsible
1910: 66 6f 72 20 64 6f 77 6e 6c 6f 61 64 69 6e 67 20 for downloading
1920: 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 the source code
1930: 66 6f 72 20 74 68 65 20 61 70 70 72 6f 70 72 69 for the appropri
1940: 61 74 65 20 76 65 72 73 69 6f 6e 20 74 68 61 74 ate version that
1950: 0a 77 69 6c 6c 20 63 6f 6d 70 69 6c 65 20 61 6e .will compile an
1960: 64 20 6c 69 6e 6b 20 61 67 61 69 6e 73 74 20 74 d link against t
1970: 68 65 20 63 75 72 72 65 6e 74 20 76 65 72 73 69 he current versi
1980: 6f 6e 20 6f 66 20 54 63 6c 20 28 75 73 65 72 20 on of Tcl (user
1990: 72 65 71 75 65 73 74 65 64 0a 76 65 72 73 69 6f requested.versio
19a0: 6e 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 69 n can be found i
19b0: 6e 20 22 54 43 4c 56 45 52 53 22 2c 20 77 68 69 n "TCLVERS", whi
19c0: 6c 65 20 74 68 65 20 61 63 74 75 61 6c 20 76 65 le the actual ve
19d0: 72 73 69 6f 6e 20 6d 75 73 74 20 62 65 20 72 65 rsion must be re
19e0: 71 75 65 73 74 65 64 0a 66 72 6f 6d 20 74 68 65 quested.from the
19f0: 20 22 74 63 6c 43 6f 6e 66 69 67 2e 73 68 22 20 "tclConfig.sh"
1a00: 73 63 72 69 70 74 29 2c 20 63 6f 6d 70 69 6c 69 script), compili
1a10: 6e 67 20 69 74 2c 20 69 6e 73 74 61 6c 6c 69 6e ng it, installin
1a20: 67 20 61 20 66 75 6e 63 74 69 6f 6e 61 6c 20 63 g a functional c
1a30: 6f 70 79 0a 69 6e 74 6f 20 74 68 65 20 70 65 72 opy.into the per
1a40: 2d 70 72 6f 6a 65 63 74 20 22 69 6e 73 74 22 20 -project "inst"
1a50: 64 69 72 65 63 74 6f 72 79 2c 20 61 6e 64 20 69 directory, and i
1a60: 6e 73 74 61 6c 6c 69 6e 67 20 61 6e 79 74 68 69 nstalling anythi
1a70: 6e 67 20 74 68 61 74 20 6e 65 65 64 73 20 74 6f ng that needs to
1a80: 0a 62 65 20 69 6e 20 74 68 65 20 54 63 6c 6b 69 .be in the Tclki
1a90: 74 27 73 20 56 46 53 20 72 6f 6f 74 20 69 6e 74 t's VFS root int
1aa0: 6f 20 74 68 65 20 70 65 72 2d 70 72 6f 6a 65 63 o the per-projec
1ab0: 74 20 22 6f 75 74 22 20 64 69 72 65 63 74 6f 72 t "out" director
1ac0: 79 2e 0a 0a 54 68 65 20 65 78 63 65 70 74 69 6f y...The exceptio
1ad0: 6e 20 74 6f 20 74 68 69 73 20 69 73 20 74 68 65 n to this is the
1ae0: 20 22 6b 69 74 73 68 22 20 61 6e 64 20 22 6b 69 "kitsh" and "ki
1af0: 74 64 6c 6c 22 20 70 72 6f 6a 65 63 74 73 2e 20 tdll" projects.
1b00: 20 54 68 65 79 20 61 72 65 20 74 68 65 20 67 6c They are the gl
1b10: 75 65 0a 74 68 61 74 20 62 69 6e 64 73 20 61 6c ue.that binds al
1b20: 6c 20 74 68 65 20 69 6e 64 69 76 69 64 75 61 6c l the individual
1b30: 20 70 72 6f 6a 65 63 74 73 20 74 6f 67 65 74 68 projects togeth
1b40: 65 72 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 er into a single
1b50: 20 65 78 65 63 75 74 61 62 6c 65 2e 20 20 49 74 executable. It
1b60: 73 0a 62 75 69 6c 64 20 73 63 72 69 70 74 20 64 s.build script d
1b70: 6f 65 73 20 6e 6f 74 20 63 72 65 61 74 65 20 61 oes not create a
1b80: 6e 20 22 69 6e 73 74 22 20 6f 72 20 61 6e 20 22 n "inst" or an "
1b90: 6f 75 74 22 20 64 69 72 65 63 74 6f 72 79 20 62 out" directory b
1ba0: 65 63 61 75 73 65 20 69 74 20 69 73 20 6e 6f 74 ecause it is not
1bb0: 0a 61 20 6c 69 62 72 61 72 79 2e 20 20 49 6e 73 .a library. Ins
1bc0: 74 65 61 64 2c 20 69 74 20 63 6f 6c 6c 65 63 74 tead, it collect
1bd0: 73 20 61 6c 6c 20 74 68 65 20 6f 74 68 65 72 20 s all the other
1be0: 70 72 6f 6a 65 63 74 27 73 20 22 6f 75 74 22 20 project's "out"
1bf0: 64 69 72 65 63 74 6f 72 69 65 73 0a 69 6e 74 6f directories.into
1c00: 20 61 20 73 69 6e 67 6c 65 20 64 69 72 65 63 74 a single direct
1c10: 6f 72 79 20 28 73 74 61 72 70 61 63 6b 2e 76 66 ory (starpack.vf
1c20: 73 29 2c 20 61 73 20 77 65 6c 6c 20 61 20 73 74 s), as well a st
1c30: 61 74 69 63 20 66 69 6c 65 20 28 62 6f 6f 74 2e atic file (boot.
1c40: 74 63 6c 29 2e 0a 49 74 20 74 68 65 6e 20 63 6f tcl)..It then co
1c50: 6d 70 69 6c 65 73 20 74 68 65 20 73 6f 75 72 63 mpiles the sourc
1c60: 65 20 63 6f 64 65 2c 20 61 6e 64 20 74 68 65 6e e code, and then
1c70: 20 69 6e 73 74 61 6c 6c 73 20 74 68 65 20 56 46 installs the VF
1c80: 53 20 6f 6e 74 6f 20 74 68 65 20 72 65 73 75 6c S onto the resul
1c90: 74 69 6e 67 0a 65 78 65 63 75 74 61 62 6c 65 2e ting.executable.
1ca0: 20 20 54 68 65 20 56 46 53 20 69 73 20 63 72 65 The VFS is cre
1cb0: 61 74 65 64 20 62 79 20 74 68 65 20 22 69 6e 73 ated by the "ins
1cc0: 74 61 6c 6c 76 66 73 2e 74 63 6c 22 20 73 63 72 tallvfs.tcl" scr
1cd0: 69 70 74 20 66 6f 72 20 4b 69 74 73 68 2e 20 20 ipt for Kitsh.
1ce0: 46 6f 72 0a 4b 69 74 44 4c 4c 20 74 68 65 20 56 For.KitDLL the V
1cf0: 46 53 20 69 73 20 63 72 65 61 74 65 64 20 62 79 FS is created by
1d00: 20 22 64 69 72 32 63 2e 74 63 6c 22 2e 0a 0a 49 "dir2c.tcl"...I
1d10: 66 20 74 68 65 20 22 6d 6b 34 74 63 6c 22 20 70 f the "mk4tcl" p
1d20: 72 6f 6a 65 63 74 20 66 61 69 6c 73 20 74 6f 20 roject fails to
1d30: 62 75 69 6c 64 20 28 6f 72 20 69 73 20 6e 6f 74 build (or is not
1d40: 20 72 65 71 75 65 73 74 65 64 20 74 6f 20 62 65 requested to be
1d50: 20 62 75 69 6c 74 29 2c 0a 74 68 65 20 72 65 73 built),.the res
1d60: 74 20 6f 66 20 74 68 65 20 70 72 6f 6a 65 63 74 t of the project
1d70: 20 77 69 6c 6c 20 62 65 20 62 75 69 6c 74 20 75 will be built u
1d80: 73 69 6e 67 20 7a 69 70 20 66 69 6c 65 73 20 69 sing zip files i
1d90: 6e 73 74 65 61 64 20 6f 66 20 4d 65 74 61 6b 69 nstead of Metaki
1da0: 74 0a 64 61 74 61 62 61 73 65 73 2e 0a 0a 54 6f t.databases...To
1db0: 20 63 72 65 61 74 65 20 74 68 65 20 73 74 6f 72 create the stor
1dc0: 61 67 65 20 64 61 74 61 62 61 73 65 2c 20 6f 6e age database, on
1dd0: 65 20 6f 66 20 74 77 6f 20 54 63 6c 6b 69 74 73 e of two Tclkits
1de0: 20 69 73 20 75 73 65 64 20 28 74 72 69 65 64 20 is used (tried
1df0: 69 6e 20 74 68 69 73 0a 6f 72 64 65 72 29 3a 0a in this.order):.
1e00: 09 31 2e 20 54 68 65 20 54 63 6c 6b 69 74 20 73 .1. The Tclkit s
1e10: 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 pecified by the
1e20: 54 43 4c 4b 49 54 20 65 6e 76 69 72 6f 6e 6d 65 TCLKIT environme
1e30: 6e 74 20 76 61 72 69 61 62 6c 65 20 28 6f 72 0a nt variable (or.
1e40: 09 20 20 20 22 74 63 6c 6b 69 74 22 20 69 66 20 . "tclkit" if
1e50: 74 68 61 74 20 76 61 72 69 61 62 6c 65 20 69 73 that variable is
1e60: 20 6e 6f 74 20 73 65 74 29 20 69 66 20 69 74 20 not set) if it
1e70: 69 73 20 66 75 6e 63 74 69 6f 6e 61 6c 3b 20 6f is functional; o
1e80: 72 0a 09 32 2e 20 54 68 65 20 62 75 69 6c 74 20 r..2. The built
1e90: 54 63 6c 6b 69 74 20 69 74 73 65 6c 66 0a 0a 54 Tclkit itself..T
1ea0: 68 65 20 73 65 63 6f 6e 64 20 6d 65 74 68 6f 64 he second method
1eb0: 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 69 will not work i
1ec0: 66 20 74 68 65 20 62 75 69 6c 74 20 54 63 6c 6b f the built Tclk
1ed0: 69 74 20 69 73 20 6e 6f 74 20 65 78 65 63 75 74 it is not execut
1ee0: 61 62 6c 65 20 6f 6e 20 74 68 65 0a 63 75 72 72 able on the.curr
1ef0: 65 6e 74 20 70 6c 61 74 66 6f 72 6d 20 28 69 2e ent platform (i.
1f00: 65 2e 2c 20 69 6e 20 74 68 65 20 63 61 73 65 20 e., in the case
1f10: 6f 66 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c 61 of cross-compila
1f20: 74 69 6f 6e 29 20 61 6e 64 20 73 6f 20 69 74 20 tion) and so it
1f30: 6d 61 79 20 62 65 0a 6e 65 63 65 73 73 61 72 79 may be.necessary
1f40: 20 74 6f 20 62 6f 6f 74 73 74 72 61 70 20 61 20 to bootstrap a
1f50: 72 75 6e 6e 61 62 6c 65 20 54 63 6c 6b 69 74 20 runnable Tclkit
1f60: 66 69 72 73 74 2e 0a 0a 4b 69 74 44 4c 4c 20 6d first...KitDLL m
1f70: 6f 75 6e 74 73 20 74 68 65 20 56 46 53 20 66 6f ounts the VFS fo
1f80: 72 20 65 76 65 72 79 20 69 6e 74 65 72 70 72 65 r every interpre
1f90: 74 65 72 20 74 68 61 74 20 63 61 6c 6c 73 20 54 ter that calls T
1fa0: 63 6c 5f 49 6e 69 74 28 29 2e 20 20 54 68 65 20 cl_Init(). The
1fb0: 73 79 73 74 65 6d 0a 56 46 53 20 74 68 61 74 20 system.VFS that
1fc0: 69 73 20 63 72 65 61 74 65 64 20 61 74 20 62 75 is created at bu
1fd0: 69 6c 64 20 74 69 6d 65 20 69 73 20 6d 6f 75 6e ild time is moun
1fe0: 74 65 64 20 61 74 20 2f 2e 4b 49 54 44 4c 4c 5f ted at /.KITDLL_
1ff0: 54 43 4c 2e 20 20 41 64 64 69 74 69 6f 6e 61 6c TCL. Additional
2000: 6c 79 2c 0a 69 66 20 74 68 65 72 65 20 69 73 20 ly,.if there is
2010: 61 20 5a 49 50 20 66 69 6c 65 20 61 70 70 65 6e a ZIP file appen
2020: 64 65 64 20 74 6f 20 74 68 65 20 44 4c 4c 20 69 ded to the DLL i
2030: 74 20 77 69 6c 6c 20 62 65 20 6d 6f 75 6e 74 65 t will be mounte
2040: 64 20 61 74 20 2f 2e 4b 49 54 44 4c 4c 5f 55 53 d at /.KITDLL_US
2050: 45 52 0a 61 6e 64 20 69 66 20 74 68 65 72 65 20 ER.and if there
2060: 69 73 20 61 20 5a 49 50 20 66 69 6c 65 20 61 70 is a ZIP file ap
2070: 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 65 78 pended to the ex
2080: 65 63 75 74 61 62 6c 65 20 69 74 20 77 69 6c 6c ecutable it will
2090: 20 62 65 20 6d 6f 75 6e 74 65 64 20 61 74 0a 2f be mounted at./
20a0: 2e 4b 49 54 44 4c 4c 5f 41 50 50 2e 20 20 41 6c .KITDLL_APP. Al
20b0: 6c 20 56 46 53 65 73 20 74 68 61 74 20 61 72 65 l VFSes that are
20c0: 20 6d 6f 75 6e 74 65 64 20 68 61 76 65 20 74 68 mounted have th
20d0: 65 20 22 6c 69 62 22 20 73 75 62 2d 64 69 72 65 e "lib" sub-dire
20e0: 63 74 6f 72 79 20 61 70 70 65 6e 64 65 64 0a 74 ctory appended.t
20f0: 6f 20 74 68 65 20 69 6e 74 65 72 70 72 65 74 65 o the interprete
2100: 72 73 20 22 61 75 74 6f 5f 70 61 74 68 22 20 76 rs "auto_path" v
2110: 61 72 69 61 62 6c 65 2e 0a ariable..