Artifact f55796d36b016c7a878f2e110c65814b30455d3b:
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 20 6f 72 20 61 20 4b 69 74 44 4c 4c 20 6e 61 " or a KitDLL na
0040: 6d 65 64 0a 22 6c 69 62 74 63 6c 6b 69 74 3c 76 med."libtclkit<v
0050: 65 72 73 69 6f 6e 3e 2e 73 6f 22 2e 0a 0a 2d 2d ersion>.so"...--
0060: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 55 73 -------------.Us
0070: 69 6e 67 20 54 68 69 73 20 54 6f 6f 6c 0a 2d 2d ing This Tool.--
0080: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 55 73 -------------.Us
0090: 61 67 65 3a 0a 09 6b 69 74 63 72 65 61 74 6f 72 age:..kitcreator
00a0: 20 5b 7b 3c 76 65 72 73 69 6f 6e 3e 20 7c 20 63 [{<version> | c
00b0: 76 73 5f 3c 63 76 73 54 61 67 3e 20 7c 20 63 6c vs_<cvsTag> | cl
00c0: 65 61 6e 20 7c 20 64 69 73 74 63 6c 65 61 6e 7d ean | distclean}
00d0: 5d 0a 09 20 20 20 20 20 20 20 20 20 20 20 5b 3c ].. [<
00e0: 63 6f 6e 66 69 67 75 72 65 5f 6f 70 74 69 6f 6e configure_option
00f0: 73 2e 2e 2e 3e 5d 0a 0a 09 57 68 65 72 65 3a 0a s...>]...Where:.
0100: 09 09 76 65 72 73 69 6f 6e 20 20 20 20 20 20 20 ..version
0110: 20 20 20 20 20 69 73 20 61 20 54 63 6c 20 76 65 is a Tcl ve
0120: 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20 28 65 2e rsion number (e.
0130: 67 2e 2c 20 38 2e 34 2e 31 39 29 0a 09 09 63 76 g., 8.4.19)...cv
0140: 73 54 61 67 20 20 20 20 20 20 20 20 20 20 20 20 sTag
0150: 20 69 73 20 61 20 43 56 53 20 72 65 6c 65 61 73 is a CVS releas
0160: 65 20 74 61 67 20 28 65 2e 67 2e 2c 20 48 45 41 e tag (e.g., HEA
0170: 44 29 0a 09 09 63 6f 6e 66 69 67 75 72 65 5f 6f D)...configure_o
0180: 70 74 69 6f 6e 73 20 20 61 72 65 20 6f 70 74 69 ptions are opti
0190: 6f 6e 73 20 74 6f 20 70 61 73 73 20 74 6f 20 73 ons to pass to s
01a0: 75 62 6f 72 64 69 6e 61 74 65 20 63 6f 6e 66 69 ubordinate confi
01b0: 67 75 72 65 0a 09 09 20 20 20 20 20 20 20 20 20 gure...
01c0: 20 20 20 20 20 20 20 20 20 20 73 63 72 69 70 74 script
01d0: 73 20 28 65 2e 67 2e 2c 20 2d 2d 65 6e 61 62 6c s (e.g., --enabl
01e0: 65 2d 36 34 62 69 74 29 0a 0a 09 44 65 66 61 75 e-64bit)...Defau
01f0: 6c 74 20 69 73 20 74 6f 20 63 72 65 61 74 65 20 lt is to create
0200: 61 20 54 63 6c 6b 69 74 20 66 72 6f 6d 20 54 63 a Tclkit from Tc
0210: 6c 20 76 65 72 73 69 6f 6e 20 38 2e 34 2e 31 39 l version 8.4.19
0220: 0a 0a 45 78 61 6d 70 6c 65 73 3a 0a 09 31 2e 20 ..Examples:..1.
0230: 43 72 65 61 74 65 20 61 20 54 63 6c 6b 69 74 3a Create a Tclkit:
0240: 0a 09 09 61 2e 20 24 20 2e 2f 6b 69 74 63 72 65 ...a. $ ./kitcre
0250: 61 74 6f 72 0a 0a 09 32 2e 20 43 72 65 61 74 65 ator...2. Create
0260: 20 61 20 54 63 6c 6b 69 74 20 66 6f 72 20 54 63 a Tclkit for Tc
0270: 6c 20 38 2e 35 2e 38 3a 0a 09 09 61 2e 20 24 20 l 8.5.8:...a. $
0280: 2e 2f 6b 69 74 63 72 65 61 74 6f 72 20 38 2e 35 ./kitcreator 8.5
0290: 2e 38 0a 0a 09 33 2e 20 43 72 65 61 74 65 20 61 .8...3. Create a
02a0: 20 54 63 6c 6b 69 74 20 66 6f 72 20 54 63 6c 20 Tclkit for Tcl
02b0: 66 72 6f 6d 20 43 56 53 20 48 45 41 44 3a 0a 09 from CVS HEAD:..
02c0: 09 61 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61 74 .a. $ ./kitcreat
02d0: 6f 72 20 63 76 73 5f 48 45 41 44 0a 0a 09 34 2e or cvs_HEAD...4.
02e0: 20 43 6f 6d 70 69 6c 65 20 61 20 36 34 2d 62 69 Compile a 64-bi
02f0: 74 20 54 63 6c 6b 69 74 3a 0a 09 09 61 2e 20 24 t Tclkit:...a. $
0300: 20 2e 2f 6b 69 74 63 72 65 61 74 6f 72 20 2d 2d ./kitcreator --
0310: 65 6e 61 62 6c 65 2d 36 34 62 69 74 0a 0a 09 35 enable-64bit...5
0320: 2e 20 43 72 6f 73 73 2d 63 6f 6d 70 69 6c 65 20 . Cross-compile
0330: 61 20 54 63 6c 6b 69 74 3a 0a 09 09 61 2e 20 42 a Tclkit:...a. B
0340: 6f 6f 74 73 74 72 61 70 20 28 6f 70 74 69 6f 6e ootstrap (option
0350: 61 6c 2c 20 79 6f 75 20 63 61 6e 20 75 73 65 20 al, you can use
0360: 61 6e 20 65 78 69 73 74 69 6e 67 20 54 63 6c 6b an existing Tclk
0370: 69 74 29 3a 0a 09 09 09 69 2e 20 20 20 24 20 2e it):....i. $ .
0380: 2f 6b 69 74 63 72 65 61 74 6f 72 0a 09 09 09 69 /kitcreator....i
0390: 69 2e 20 20 24 20 6d 76 20 74 63 6c 6b 69 74 2d i. $ mv tclkit-
03a0: 38 2e 34 2e 31 39 20 74 63 6c 6b 69 74 2d 6c 6f 8.4.19 tclkit-lo
03b0: 63 61 6c 0a 09 09 09 69 69 69 2e 20 24 20 54 43 cal....iii. $ TC
03c0: 4c 4b 49 54 3d 22 60 70 77 64 60 2f 74 63 6c 6b LKIT="`pwd`/tclk
03d0: 69 74 2d 6c 6f 63 61 6c 22 0a 09 09 09 69 76 2e it-local"....iv.
03e0: 20 20 24 20 65 78 70 6f 72 74 20 54 43 4c 4b 49 $ export TCLKI
03f0: 54 0a 09 09 62 2e 20 43 72 6f 73 73 2d 63 6f 6d T...b. Cross-com
0400: 70 69 6c 65 3a 0a 09 09 09 69 2e 20 20 20 24 20 pile:....i. $
0410: 43 43 3d 6d 69 70 73 65 6c 2d 6c 69 6e 75 78 2d CC=mipsel-linux-
0420: 75 63 6c 69 62 63 2d 67 63 63 0a 09 09 09 69 69 uclibc-gcc....ii
0430: 2e 20 20 24 20 43 58 58 3d 66 61 6c 73 65 0a 09 . $ CXX=false..
0440: 09 09 69 69 69 2e 20 24 20 41 52 3d 6d 69 70 73 ..iii. $ AR=mips
0450: 65 6c 2d 6c 69 6e 75 78 2d 75 63 6c 69 62 63 2d el-linux-uclibc-
0460: 61 72 0a 09 09 09 69 76 2e 20 20 24 20 52 41 4e ar....iv. $ RAN
0470: 4c 49 42 3d 6d 69 70 73 65 6c 2d 6c 69 6e 75 78 LIB=mipsel-linux
0480: 2d 75 63 6c 69 62 63 2d 72 61 6e 6c 69 62 0a 09 -uclibc-ranlib..
0490: 09 09 76 2e 20 20 20 24 20 65 78 70 6f 72 74 20 ..v. $ export
04a0: 43 43 20 43 58 58 20 41 52 20 52 41 4e 4c 49 42 CC CXX AR RANLIB
04b0: 0a 09 09 76 2e 20 20 20 24 20 2e 2f 6b 69 74 63 ...v. $ ./kitc
04c0: 72 65 61 74 6f 72 20 2d 2d 68 6f 73 74 3d 6d 69 reator --host=mi
04d0: 70 73 65 6c 2d 6c 69 6e 75 78 2d 75 63 6c 69 62 psel-linux-uclib
04e0: 63 0a 0a 09 36 2e 20 43 6f 6d 70 69 6c 65 20 61 c...6. Compile a
04f0: 20 36 34 2d 62 69 74 20 54 63 6c 6b 69 74 20 38 64-bit Tclkit 8
0500: 2e 35 2e 38 20 75 73 69 6e 67 20 53 75 6e 53 74 .5.8 using SunSt
0510: 75 64 69 6f 20 31 32 2e 31 20 6f 6e 20 53 6f 6c udio 12.1 on Sol
0520: 61 72 69 73 2f 78 38 36 3a 0a 09 09 61 2e 20 24 aris/x86:...a. $
0530: 20 43 43 3d 27 2f 6f 70 74 2f 73 75 6e 73 74 75 CC='/opt/sunstu
0540: 64 69 6f 31 32 2e 31 2f 62 69 6e 2f 63 63 20 2d dio12.1/bin/cc -
0550: 6d 36 34 27 0a 09 09 62 2e 20 24 20 43 58 58 3d m64'...b. $ CXX=
0560: 27 2f 6f 70 74 2f 73 75 6e 73 74 75 64 69 6f 31 '/opt/sunstudio1
0570: 32 2e 31 2f 62 69 6e 2f 43 43 20 2d 6d 36 34 27 2.1/bin/CC -m64'
0580: 0a 09 09 63 2e 20 24 20 50 41 54 43 48 3d 27 67 ...c. $ PATCH='g
0590: 70 61 74 63 68 27 0a 09 09 63 2e 20 24 20 65 78 patch'...c. $ ex
05a0: 70 6f 72 74 20 43 43 20 43 58 58 20 50 41 54 43 port CC CXX PATC
05b0: 48 0a 09 09 64 2e 20 24 20 2e 2f 6b 69 74 63 72 H...d. $ ./kitcr
05c0: 65 61 74 6f 72 20 38 2e 35 2e 38 20 2d 2d 65 6e eator 8.5.8 --en
05d0: 61 62 6c 65 2d 36 34 62 69 74 0a 0a 09 37 2e 20 able-64bit...7.
05e0: 54 6f 20 63 6c 65 61 6e 20 75 70 20 70 6f 73 74 To clean up post
05f0: 2d 62 75 69 6c 64 3a 0a 09 09 61 2e 20 24 20 2e -build:...a. $ .
0600: 2f 6b 69 74 63 72 65 61 74 6f 72 20 63 6c 65 61 /kitcreator clea
0610: 6e 0a 0a 09 38 2e 20 43 72 65 61 74 65 20 61 20 n...8. Create a
0620: 54 63 6c 6b 69 74 20 77 69 74 68 6f 75 74 20 4d Tclkit without M
0630: 65 74 61 6b 69 74 34 20 73 75 70 70 6f 72 74 20 etakit4 support
0640: 28 66 61 6c 6c 73 20 62 61 63 6b 20 74 6f 20 5a (falls back to Z
0650: 69 70 20 66 6f 72 20 73 74 6f 72 61 67 65 29 3a ip for storage):
0660: 0a 09 09 61 2e 20 4b 49 54 43 52 45 41 54 4f 52 ...a. KITCREATOR
0670: 5f 50 4b 47 53 3d 27 74 6b 20 69 74 63 6c 27 0a _PKGS='tk itcl'.
0680: 09 09 62 2e 20 65 78 70 6f 72 74 20 4b 49 54 43 ..b. export KITC
0690: 52 45 41 54 4f 52 5f 50 4b 47 53 0a 09 09 63 2e REATOR_PKGS...c.
06a0: 20 2e 2f 6b 69 74 63 72 65 61 74 6f 72 0a 0a 09 ./kitcreator...
06b0: 39 2e 20 43 72 65 61 74 65 20 61 20 54 63 6c 6b 9. Create a Tclk
06c0: 69 74 20 77 69 74 68 20 4d 65 74 61 6b 69 74 34 it with Metakit4
06d0: 20 73 75 70 70 6f 72 74 2c 20 62 75 74 20 75 73 support, but us
06e0: 69 6e 67 20 5a 69 70 20 66 6f 72 20 73 74 6f 72 ing Zip for stor
06f0: 61 67 65 3a 0a 09 09 61 2e 20 24 20 2e 2f 6b 69 age:...a. $ ./ki
0700: 74 63 72 65 61 74 6f 72 20 2d 2d 65 6e 61 62 6c tcreator --enabl
0710: 65 2d 6b 69 74 2d 73 74 6f 72 61 67 65 3d 7a 69 e-kit-storage=zi
0720: 70 0a 0a 09 31 30 2e 20 43 72 65 61 74 65 20 61 p...10. Create a
0730: 20 54 63 6c 6b 69 74 20 77 69 74 68 20 4d 65 74 Tclkit with Met
0740: 61 6b 69 74 34 20 73 75 70 70 6f 72 74 2c 20 62 akit4 support, b
0750: 75 74 20 75 73 69 6e 67 20 43 2d 56 46 53 20 66 ut using C-VFS f
0760: 6f 72 20 73 74 6f 72 61 67 65 0a 09 09 61 2e 20 or storage...a.
0770: 24 20 2e 2f 6b 69 74 63 72 65 61 74 6f 72 20 2d $ ./kitcreator -
0780: 2d 65 6e 61 62 6c 65 2d 6b 69 74 2d 73 74 6f 72 -enable-kit-stor
0790: 61 67 65 3d 63 76 66 73 0a 0a 09 31 31 2e 20 43 age=cvfs...11. C
07a0: 72 65 61 74 65 20 61 20 4b 69 74 44 4c 4c 20 77 reate a KitDLL w
07b0: 69 74 68 6f 75 74 20 4d 65 74 61 6b 69 74 20 73 ithout Metakit s
07c0: 75 70 70 6f 72 74 20 28 77 69 6c 6c 20 6e 6f 74 upport (will not
07d0: 20 63 72 65 61 74 65 20 61 20 54 63 6c 6b 69 74 create a Tclkit
07e0: 0a 09 20 20 20 20 62 69 6e 61 72 79 2c 20 6a 75 .. binary, ju
07f0: 73 74 20 74 68 65 20 6c 69 62 72 61 72 79 29 3a st the library):
0800: 0a 09 09 61 2e 20 24 20 4b 49 54 43 52 45 41 54 ...a. $ KITCREAT
0810: 4f 52 5f 50 4b 47 53 3d 27 74 6b 20 69 74 63 6c OR_PKGS='tk itcl
0820: 20 6b 69 74 64 6c 6c 27 0a 09 09 62 2e 20 24 20 kitdll'...b. $
0830: 65 78 70 6f 72 74 20 4b 49 54 43 52 45 41 54 4f export KITCREATO
0840: 52 5f 50 4b 47 53 0a 09 09 63 2e 20 24 20 2e 2f R_PKGS...c. $ ./
0850: 6b 69 74 63 72 65 61 74 6f 72 0a 0a 45 6e 76 69 kitcreator..Envi
0860: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 ronment variable
0870: 73 3a 0a 09 31 2e 20 4d 41 4b 45 0a 09 09 53 70 s:..1. MAKE...Sp
0880: 65 63 69 66 69 65 73 20 74 68 65 20 74 6f 6f 6c ecifies the tool
0890: 20 79 6f 75 20 77 69 73 68 20 74 6f 20 62 65 20 you wish to be
08a0: 63 61 6c 6c 65 64 20 74 6f 20 62 75 69 6c 64 20 called to build
08b0: 74 61 72 67 65 74 73 0a 09 09 66 72 6f 6d 20 61 targets...from a
08c0: 20 4d 61 6b 65 66 69 6c 65 2e 20 20 54 68 69 73 Makefile. This
08d0: 20 73 63 72 69 70 74 20 69 73 20 67 65 6e 65 72 script is gener
08e0: 61 6c 6c 79 20 6d 6f 72 65 20 77 65 6c 6c 20 74 ally more well t
08f0: 65 73 74 65 64 0a 09 09 77 69 74 68 20 47 4e 55 ested...with GNU
0900: 20 4d 61 6b 65 2e 0a 0a 09 32 2e 20 50 41 54 43 Make....2. PATC
0910: 48 0a 09 09 53 70 65 63 69 66 69 65 73 20 74 68 H...Specifies th
0920: 65 20 74 6f 6f 6c 20 79 6f 75 20 77 69 73 68 20 e tool you wish
0930: 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 74 6f 20 to be called to
0940: 61 70 70 6c 79 20 75 6e 69 66 69 65 64 0a 09 09 apply unified...
0950: 64 69 66 66 20 70 61 74 63 68 65 73 2e 20 20 54 diff patches. T
0960: 68 69 73 20 73 63 72 69 70 74 20 69 73 20 67 65 his script is ge
0970: 6e 65 72 61 6c 6c 79 20 6d 6f 72 65 20 77 65 6c nerally more wel
0980: 6c 20 74 65 73 74 65 64 20 77 69 74 68 0a 09 09 l tested with...
0990: 47 4e 55 20 50 61 74 63 68 2e 20 0a 0a 09 33 2e GNU Patch. ...3.
09a0: 20 54 43 4c 4b 49 54 0a 09 09 53 70 65 63 69 66 TCLKIT...Specif
09b0: 79 20 74 68 65 20 70 61 74 68 20 74 6f 20 61 20 y the path to a
09c0: 54 63 6c 6b 69 74 20 74 68 61 74 20 69 73 20 72 Tclkit that is r
09d0: 75 6e 6e 61 62 6c 65 20 6f 6e 20 74 68 65 20 63 unnable on the c
09e0: 75 72 72 65 6e 74 0a 09 09 73 79 73 74 65 6d 2e urrent...system.
09f0: 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 The default is
0a00: 20 22 74 63 6c 6b 69 74 22 2e 20 20 41 20 77 6f "tclkit". A wo
0a10: 72 6b 69 6e 67 20 74 63 6c 6b 69 74 20 69 73 20 rking tclkit is
0a20: 72 65 71 75 69 72 65 64 0a 09 09 66 6f 72 20 63 required...for c
0a30: 72 6f 73 73 2d 63 6f 6d 70 69 6c 69 6e 67 20 54 ross-compiling T
0a40: 63 6c 6b 69 74 73 2e 0a 0a 09 34 2e 20 53 54 41 clkits....4. STA
0a50: 54 49 43 54 4b 0a 09 09 53 70 65 63 69 66 79 20 TICTK...Specify
0a60: 74 68 69 73 20 61 73 20 22 31 22 20 74 6f 20 73 this as "1" to s
0a70: 74 61 74 69 63 61 6c 6c 79 20 6c 69 6e 6b 20 74 tatically link t
0a80: 6f 20 54 6b 2e 20 20 54 68 65 20 64 65 66 61 75 o Tk. The defau
0a90: 6c 74 0a 09 09 61 63 74 69 6f 6e 20 6f 6e 20 6d lt...action on m
0aa0: 6f 73 74 20 70 6c 61 74 66 6f 72 6d 73 20 69 73 ost platforms is
0ab0: 20 74 6f 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 to dynamically
0ac0: 6c 69 6e 6b 20 74 6f 20 54 6b 2e 20 20 57 68 65 link to Tk. Whe
0ad0: 6e 0a 09 09 62 75 69 6c 64 69 6e 67 20 4b 69 74 n...building Kit
0ae0: 44 4c 4c 2c 20 53 54 41 54 49 43 54 4b 20 69 73 DLL, STATICTK is
0af0: 20 22 31 22 20 62 79 20 64 65 66 61 75 6c 74 2e "1" by default.
0b00: 20 20 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f If you want to
0b10: 0a 09 09 65 6e 61 62 6c 65 20 64 79 6e 61 6d 69 ...enable dynami
0b20: 63 20 6c 69 6e 6b 69 6e 67 20 6f 66 20 54 6b 20 c linking of Tk
0b30: 77 69 74 68 20 4b 69 74 44 4c 4c 20 79 6f 75 20 with KitDLL you
0b40: 77 69 6c 6c 20 68 61 76 65 20 74 6f 0a 09 09 73 will have to...s
0b50: 70 65 63 69 66 79 20 74 68 69 73 20 61 73 20 22 pecify this as "
0b60: 2d 31 22 2e 0a 0a 09 35 2e 20 53 54 41 54 49 43 -1"....5. STATIC
0b70: 4d 4b 34 0a 09 09 53 70 65 63 69 66 79 20 74 68 MK4...Specify th
0b80: 69 73 20 61 73 20 22 30 22 20 74 6f 20 61 74 74 is as "0" to att
0b90: 65 6d 70 74 20 74 6f 20 63 72 65 61 74 65 20 63 empt to create c
0ba0: 72 65 61 74 65 20 74 68 65 20 22 6d 6b 34 74 63 reate the "mk4tc
0bb0: 6c 22 0a 09 09 70 72 6f 6a 65 63 74 20 61 73 20 l"...project as
0bc0: 61 20 73 68 61 72 65 64 20 6f 62 6a 65 63 74 2e a shared object.
0bd0: 20 20 49 66 20 74 68 69 73 20 66 61 69 6c 73 2c If this fails,
0be0: 20 69 74 20 77 69 6c 6c 20 66 61 6c 6c 20 62 61 it will fall ba
0bf0: 63 6b 0a 09 09 74 6f 20 62 75 69 6c 64 69 6e 67 ck...to building
0c00: 20 73 74 61 74 69 63 61 6c 6c 79 2e 20 20 53 70 statically. Sp
0c10: 65 63 69 66 79 20 69 74 20 61 73 20 22 2d 31 22 ecify it as "-1"
0c20: 20 74 6f 20 66 6f 72 63 65 20 62 75 69 6c 64 69 to force buildi
0c30: 6e 67 0a 09 09 69 74 20 61 73 20 61 20 73 68 61 ng...it as a sha
0c40: 72 65 64 20 6f 62 6a 65 63 74 2e 20 20 41 6e 79 red object. Any
0c50: 20 6f 74 68 65 72 20 76 61 6c 75 65 2c 20 69 6e other value, in
0c60: 63 6c 75 64 69 6e 67 20 62 65 69 6e 67 20 75 6e cluding being un
0c70: 73 65 74 0a 09 09 72 65 73 75 6c 74 73 20 69 6e set...results in
0c80: 20 22 6d 6b 34 74 63 6c 22 20 62 65 69 6e 67 20 "mk4tcl" being
0c90: 62 75 69 6c 74 20 61 6e 64 20 6c 69 6e 6b 65 64 built and linked
0ca0: 20 73 74 61 74 69 63 61 6c 6c 79 2e 20 20 4b 69 statically. Ki
0cb0: 74 44 49 4c 4c 0a 09 09 73 65 74 73 20 74 68 69 tDILL...sets thi
0cc0: 73 20 74 6f 20 76 61 72 69 61 62 6c 65 20 74 6f s to variable to
0cd0: 20 22 30 22 2e 20 20 49 66 20 4d 65 74 61 6b 69 "0". If Metaki
0ce0: 74 34 20 69 73 20 62 75 69 6c 74 20 73 68 61 72 t4 is built shar
0cf0: 65 64 2c 20 69 74 0a 09 09 63 61 6e 6e 6f 74 20 ed, it...cannot
0d00: 62 65 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 be used for the
0d10: 6b 69 74 20 73 74 6f 72 61 67 65 20 66 6f 72 20 kit storage for
0d20: 54 63 6c 6b 69 74 2e 0a 0a 09 36 2e 20 53 54 52 Tclkit....6. STR
0d30: 49 50 0a 09 09 53 70 65 63 69 66 69 65 73 20 74 IP...Specifies t
0d40: 68 65 20 74 6f 6f 6c 20 79 6f 75 20 77 69 73 68 he tool you wish
0d50: 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 74 6f to be called to
0d60: 20 73 74 72 69 70 20 6f 62 6a 65 63 74 20 66 69 strip object fi
0d70: 6c 65 73 2c 0a 09 09 61 72 63 68 69 76 65 73 2c les,...archives,
0d80: 20 61 6e 64 20 73 68 61 72 65 64 20 6f 62 6a 65 and shared obje
0d90: 63 74 73 2e 20 20 54 68 65 20 64 65 66 61 75 6c cts. The defaul
0da0: 74 20 69 73 20 22 73 74 72 69 70 22 2e 20 20 59 t is "strip". Y
0db0: 6f 75 0a 09 09 73 68 6f 75 6c 64 20 70 72 6f 62 ou...should prob
0dc0: 61 62 6c 79 20 73 65 74 20 74 68 69 73 20 69 66 ably set this if
0dd0: 20 79 6f 75 20 61 72 65 20 63 72 6f 73 73 2d 63 you are cross-c
0de0: 6f 6d 70 69 6c 69 6e 67 2e 0a 0a 09 37 2e 20 4b ompiling....7. K
0df0: 49 54 43 52 45 41 54 4f 52 5f 50 4b 47 53 0a 09 ITCREATOR_PKGS..
0e00: 09 53 70 65 63 69 66 79 20 77 68 69 63 68 20 6e .Specify which n
0e10: 6f 6e 2d 72 65 71 75 69 72 65 64 20 70 61 63 6b on-required pack
0e20: 61 67 65 73 20 74 6f 20 62 75 69 6c 64 2e 20 20 ages to build.
0e30: 54 68 65 20 64 65 66 61 75 6c 74 20 6c 69 73 74 The default list
0e40: 0a 09 09 69 73 3a 0a 09 09 09 74 6b 20 69 74 63 ...is:....tk itc
0e50: 6c 20 6d 6b 34 74 63 6c 0a 0a 09 09 49 66 20 6d l mk4tcl....If m
0e60: 6b 34 74 63 6c 20 69 73 20 6e 6f 74 20 70 72 65 k4tcl is not pre
0e70: 73 65 6e 74 20 61 20 5a 69 70 2d 62 61 73 65 64 sent a Zip-based
0e80: 20 73 74 6f 72 61 67 65 20 6d 65 63 68 61 6e 69 storage mechani
0e90: 73 6d 20 77 69 6c 6c 20 62 65 0a 09 09 75 73 65 sm will be...use
0ea0: 64 20 69 6e 73 74 65 61 64 2e 20 20 54 6f 20 73 d instead. To s
0eb0: 70 65 63 69 66 79 20 74 68 61 74 20 74 68 65 20 pecify that the
0ec0: 64 65 66 61 75 6c 74 20 62 65 20 75 73 65 64 2c default be used,
0ed0: 20 64 6f 20 6e 6f 74 20 73 65 74 0a 09 09 74 68 do not set...th
0ee0: 69 73 20 6f 72 20 73 65 74 20 69 74 20 74 6f 20 is or set it to
0ef0: 74 68 65 20 65 6d 70 74 79 20 73 74 72 69 6e 67 the empty string
0f00: 2e 20 20 54 6f 20 73 70 65 63 69 66 79 20 74 68 . To specify th
0f10: 61 74 20 6e 6f 0a 09 09 6e 6f 6e 2d 72 65 71 75 at no...non-requ
0f20: 69 72 65 64 20 70 61 63 6b 61 67 65 73 20 62 65 ired packages be
0f30: 20 62 75 69 6c 74 2c 20 73 65 74 20 69 74 20 74 built, set it t
0f40: 6f 20 61 20 73 74 72 69 6e 67 20 74 68 61 74 0a o a string that.
0f50: 09 09 63 6f 6e 74 61 69 6e 73 20 6f 6e 6c 79 20 ..contains only
0f60: 77 68 69 74 65 20 73 70 61 63 65 2e 0a 0a 09 09 white space.....
0f70: 49 66 20 22 6b 69 74 64 6c 6c 22 20 69 73 20 73 If "kitdll" is s
0f80: 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 pecified in the
0f90: 6c 69 73 74 20 74 68 65 20 74 61 72 67 65 74 20 list the target
0fa0: 62 65 63 6f 6d 65 73 20 4b 69 74 44 4c 4c 0a 09 becomes KitDLL..
0fb0: 09 61 6e 64 20 6e 6f 20 54 63 6c 6b 69 74 20 77 .and no Tclkit w
0fc0: 69 6c 6c 20 62 75 69 6c 74 2c 20 62 75 74 20 69 ill built, but i
0fd0: 6e 73 74 65 61 64 20 6c 69 62 74 63 6c 6b 69 74 nstead libtclkit
0fe0: 2e 0a 0a 09 38 2e 20 4b 49 54 43 52 45 41 54 4f ....8. KITCREATO
0ff0: 52 5f 4d 49 4e 45 4e 43 4f 44 49 4e 47 53 0a 09 R_MINENCODINGS..
1000: 09 53 65 74 20 74 68 69 73 20 76 61 72 69 61 62 .Set this variab
1010: 6c 65 20 74 6f 20 61 20 6e 6f 6e 2d 65 6d 70 74 le to a non-empt
1020: 79 20 73 74 72 69 6e 67 20 74 6f 20 67 65 6e 65 y string to gene
1030: 72 61 74 65 20 61 20 54 63 6c 6b 69 74 0a 09 09 rate a Tclkit...
1040: 77 69 74 68 6f 75 74 20 61 6c 6c 20 65 6e 63 6f without all enco
1050: 64 69 6e 67 73 2c 20 6f 6e 6c 79 20 69 6e 63 6c dings, only incl
1060: 75 64 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77 uding the follow
1070: 69 6e 67 3a 0a 09 09 09 61 73 63 69 69 2e 65 6e ing:....ascii.en
1080: 63 20 63 70 31 32 35 32 2e 65 6e 63 20 69 73 6f c cp1252.enc iso
1090: 38 38 35 39 2d 31 2e 65 6e 63 20 69 73 6f 38 38 8859-1.enc iso88
10a0: 35 39 2d 31 35 2e 65 6e 63 0a 09 09 09 69 73 6f 59-15.enc....iso
10b0: 38 38 35 39 2d 32 2e 65 6e 63 20 6b 6f 69 38 2d 8859-2.enc koi8-
10c0: 72 2e 65 6e 63 20 6d 61 63 52 6f 6d 61 6e 2e 65 r.enc macRoman.e
10d0: 6e 63 0a 0a 09 39 2e 20 4b 49 54 43 52 45 41 54 nc...9. KITCREAT
10e0: 4f 52 5f 4d 49 4e 42 55 49 4c 44 0a 09 09 53 65 OR_MINBUILD...Se
10f0: 74 20 74 68 69 73 20 76 61 72 69 61 62 6c 65 20 t this variable
1100: 74 6f 20 61 20 6e 6f 6e 2d 65 6d 70 74 79 20 73 to a non-empty s
1110: 74 72 69 6e 67 20 74 6f 20 65 78 63 6c 75 64 65 tring to exclude
1120: 20 75 6e 6e 65 63 65 73 73 61 72 79 0a 09 09 70 unnecessary...p
1130: 61 63 6b 61 67 65 73 20 66 72 6f 6d 20 54 63 6c ackages from Tcl
1140: 20 62 75 69 6c 64 2e 20 20 54 68 69 73 20 65 78 build. This ex
1150: 63 6c 75 64 65 73 20 74 68 65 20 66 6f 6c 6c 6f cludes the follo
1160: 77 69 6e 67 20 70 61 63 6b 61 67 65 73 3a 0a 09 wing packages:..
1170: 09 09 74 63 6c 74 65 73 74 0a 0a 09 09 41 64 64 ..tcltest....Add
1180: 69 74 69 6f 6e 61 6c 6c 79 2c 20 61 6e 79 20 62 itionally, any b
1190: 75 6e 64 6c 65 64 20 70 61 63 6b 61 67 65 73 20 undled packages
11a0: 28 69 6e 20 74 68 65 20 22 70 6b 67 73 22 20 64 (in the "pkgs" d
11b0: 69 72 65 63 74 6f 72 79 29 0a 09 09 61 72 65 20 irectory)...are
11c0: 65 78 63 6c 75 64 65 64 2e 20 20 54 68 69 73 20 excluded. This
11d0: 74 79 70 69 63 61 6c 6c 79 20 69 6e 63 6c 75 64 typically includ
11e0: 65 73 20 28 61 73 20 6f 66 20 54 63 6c 20 38 2e es (as of Tcl 8.
11f0: 36 29 3a 0a 09 09 09 69 74 63 6c 20 74 68 72 65 6):....itcl thre
1200: 61 64 0a 0a 4b 69 74 73 68 20 43 6f 6e 66 69 67 ad..Kitsh Config
1210: 75 72 65 20 4f 70 74 69 6f 6e 73 3a 0a 09 31 2e ure Options:..1.
1220: 20 2d 2d 65 6e 61 62 6c 65 2d 6b 69 74 2d 73 74 --enable-kit-st
1230: 6f 72 61 67 65 3d 7b 7a 69 70 7c 6d 6b 34 7c 61 orage={zip|mk4|a
1240: 75 74 6f 7d 0a 09 09 53 70 65 63 69 66 79 20 77 uto}...Specify w
1250: 68 69 63 68 20 74 79 70 65 20 6f 66 20 73 74 6f hich type of sto
1260: 72 61 67 65 20 74 6f 20 75 73 65 20 77 69 74 68 rage to use with
1270: 20 74 68 65 20 54 63 6c 6b 69 74 2e 20 20 54 68 the Tclkit. Th
1280: 65 0a 09 09 64 65 66 61 75 6c 74 20 69 73 20 74 e...default is t
1290: 6f 20 61 75 74 6f 2d 64 65 74 65 63 74 2e 20 20 o auto-detect.
12a0: 41 75 74 6f 2d 64 65 74 65 63 74 69 6f 6e 20 75 Auto-detection u
12b0: 73 65 73 20 4d 6b 34 20 69 66 0a 09 09 61 76 61 ses Mk4 if...ava
12c0: 69 6c 61 62 6c 65 20 61 6e 64 20 62 75 69 6c 74 ilable and built
12d0: 20 73 74 61 74 69 63 61 6c 6c 79 2c 20 6f 74 68 statically, oth
12e0: 65 72 77 69 73 65 20 69 74 20 66 61 6c 6c 73 20 erwise it falls
12f0: 62 61 63 6b 20 74 6f 20 5a 69 70 2e 0a 0a 2d 2d back to Zip...--
1300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1310: 2d 0a 4d 65 74 68 6f 64 20 6f 66 20 4f 70 65 72 -.Method of Oper
1320: 61 74 69 6f 6e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ation.----------
1330: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 53 75 6d 6d 61 72 ---------.Summar
1340: 79 3a 0a 09 31 2e 20 22 6b 69 74 63 72 65 61 74 y:..1. "kitcreat
1350: 6f 72 22 20 63 61 6c 6c 73 20 2a 2f 62 75 69 6c or" calls */buil
1360: 64 2e 73 68 0a 09 32 2e 20 2a 2f 62 75 69 6c 64 d.sh..2. */build
1370: 2e 73 68 20 64 6f 77 6e 6c 6f 61 64 73 20 61 6e .sh downloads an
1380: 64 20 63 6f 6d 70 69 6c 65 73 20 61 70 70 72 6f d compiles appro
1390: 70 72 69 61 74 65 20 73 6f 66 74 77 61 72 65 0a priate software.
13a0: 09 33 2e 20 2a 2f 62 75 69 6c 64 2e 73 68 20 69 .3. */build.sh i
13b0: 6e 73 74 61 6c 6c 73 20 73 6f 66 74 77 61 72 65 nstalls software
13c0: 20 69 6e 74 6f 20 22 69 6e 73 74 22 20 28 72 75 into "inst" (ru
13d0: 6e 2d 74 69 6d 65 20 2b 20 63 6f 6d 70 69 6c 65 n-time + compile
13e0: 2d 74 69 6d 65 29 0a 09 34 2e 20 2a 2f 62 75 69 -time)..4. */bui
13f0: 6c 64 2e 73 68 20 69 6e 73 74 61 6c 6c 73 20 72 ld.sh installs r
1400: 75 6e 2d 74 69 6d 65 20 73 6f 66 74 77 61 72 65 un-time software
1410: 20 69 6e 74 6f 20 22 6f 75 74 22 2c 20 74 68 69 into "out", thi
1420: 73 20 77 69 6c 6c 20 62 65 0a 09 20 20 20 69 6e s will be.. in
1430: 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 54 63 cluded in the Tc
1440: 6c 6b 69 74 20 61 73 20 69 66 20 69 74 20 77 65 lkit as if it we
1450: 72 65 20 74 68 65 20 72 6f 6f 74 20 64 69 72 65 re the root dire
1460: 63 74 6f 72 79 20 6f 66 20 74 68 65 0a 09 20 20 ctory of the..
1470: 20 54 63 6c 6b 69 74 20 28 63 6f 6d 62 69 6e 65 Tclkit (combine
1480: 64 20 77 69 74 68 20 6f 74 68 65 72 20 22 6f 75 d with other "ou
1490: 74 22 20 64 69 72 65 63 74 6f 72 69 65 73 29 0a t" directories).
14a0: 09 35 2e 20 6b 69 74 73 68 2f 62 75 69 6c 64 2e .5. kitsh/build.
14b0: 73 68 20 63 6f 6d 70 69 6c 65 73 20 61 20 22 6d sh compiles a "m
14c0: 61 69 6e 22 20 66 75 6e 63 74 69 6f 6e 20 61 6e ain" function an
14d0: 64 20 6c 69 6e 6b 73 20 61 6c 6c 20 74 68 65 20 d links all the
14e0: 62 75 69 6c 74 0a 09 20 20 20 6c 69 62 72 61 72 built.. librar
14f0: 69 65 73 20 74 6f 67 65 74 68 65 72 20 69 6e 74 ies together int
1500: 6f 20 61 6e 20 65 78 65 63 75 74 61 62 6c 65 0a o an executable.
1510: 09 36 2e 20 6b 69 74 73 68 2f 62 75 69 6c 64 2e .6. kitsh/build.
1520: 73 68 20 63 6f 6d 62 69 6e 65 73 20 61 6c 6c 20 sh combines all
1530: 74 68 65 20 22 6f 75 74 22 20 64 69 72 65 63 74 the "out" direct
1540: 6f 72 69 65 73 20 69 6e 74 6f 20 6f 6e 65 0a 09 ories into one..
1550: 37 2e 20 6b 69 74 73 68 2f 62 75 69 6c 64 2e 73 7. kitsh/build.s
1560: 68 20 63 72 65 61 74 65 73 20 61 20 4d 65 74 61 h creates a Meta
1570: 6b 69 74 20 6f 72 20 5a 69 70 20 64 61 74 61 62 kit or Zip datab
1580: 61 73 65 20 66 72 6f 6d 20 74 68 65 20 63 6f 6d ase from the com
1590: 62 69 6e 65 64 0a 09 20 20 20 64 69 72 65 63 74 bined.. direct
15a0: 6f 72 69 65 73 20 61 6e 64 20 61 70 70 65 6e 64 ories and append
15b0: 73 20 74 68 61 74 20 74 6f 20 74 68 65 20 63 6f s that to the co
15c0: 6d 70 69 6c 65 64 20 65 78 65 63 75 74 61 62 6c mpiled executabl
15d0: 65 20 75 73 69 6e 67 3a 0a 09 09 61 2e 20 41 20 e using:...a. A
15e0: 54 63 6c 6b 69 74 20 66 6f 75 6e 64 20 69 6e 20 Tclkit found in
15f0: 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 the environment
1600: 76 61 72 69 61 62 6c 65 20 22 54 43 4c 4b 49 54 variable "TCLKIT
1610: 22 20 28 74 63 6c 6b 69 74 0a 09 09 20 20 20 69 " (tclkit... i
1620: 66 20 75 6e 73 65 74 29 20 69 66 20 69 74 20 69 f unset) if it i
1630: 73 20 66 75 6e 63 74 69 6f 6e 61 6c 3b 20 6f 72 s functional; or
1640: 0a 09 09 62 2e 20 54 68 65 20 62 75 69 6c 74 20 ...b. The built
1650: 6b 69 74 20 69 74 73 65 6c 66 20 28 64 6f 65 73 kit itself (does
1660: 20 6e 6f 74 20 77 6f 72 6b 20 66 6f 72 20 63 72 not work for cr
1670: 6f 73 73 2d 63 6f 6d 70 69 6c 69 6e 67 29 0a 0a oss-compiling)..
1680: 44 65 74 61 69 6c 73 3a 0a 09 54 68 65 20 67 65 Details:..The ge
1690: 6e 65 72 61 6c 20 6d 65 63 68 61 6e 69 73 6d 20 neral mechanism
16a0: 74 68 61 74 20 65 6e 61 62 6c 65 73 20 61 20 54 that enables a T
16b0: 63 6c 6b 69 74 20 74 6f 20 6f 70 65 72 61 74 65 clkit to operate
16c0: 20 69 73 20 61 20 73 6d 61 6c 6c 20 54 63 6c 0a is a small Tcl.
16d0: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 72 initialization r
16e0: 6f 75 74 69 6e 65 20 6c 69 6e 6b 65 64 20 73 74 outine linked st
16f0: 61 74 69 63 61 6c 6c 79 20 74 6f 20 74 68 65 20 atically to the
1700: 63 6f 72 65 20 6c 69 62 72 61 72 69 65 73 20 6e core libraries n
1710: 65 65 64 65 64 20 74 6f 0a 6f 70 65 72 61 74 65 eeded to.operate
1720: 20 61 20 54 63 6c 20 69 6e 74 65 72 70 72 65 74 a Tcl interpret
1730: 65 72 2c 20 74 68 65 20 54 63 6c 20 56 46 53 20 er, the Tcl VFS
1740: 4c 61 79 65 72 2c 20 61 6e 64 20 61 20 64 61 74 Layer, and a dat
1750: 61 62 61 73 65 2d 62 61 63 6b 65 64 20 28 4d 65 abase-backed (Me
1760: 74 61 6b 69 74 29 0a 56 69 72 74 75 61 6c 20 46 takit).Virtual F
1770: 69 6c 65 20 53 79 73 74 65 6d 20 74 68 61 74 20 ile System that
1780: 69 73 20 61 70 70 65 6e 64 65 64 20 74 6f 20 74 is appended to t
1790: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 65 78 he end of the ex
17a0: 65 63 75 74 61 62 6c 65 2e 0a 0a 54 68 69 73 20 ecutable...This
17b0: 70 72 6f 6a 65 63 74 20 62 72 69 6e 67 73 20 74 project brings t
17c0: 6f 67 65 74 68 65 72 20 61 6c 6c 20 6f 66 20 74 ogether all of t
17d0: 68 65 20 72 65 71 75 69 72 65 64 20 70 69 65 63 he required piec
17e0: 65 73 2c 20 70 6c 75 73 20 73 6f 6d 65 20 61 64 es, plus some ad
17f0: 64 69 74 69 6f 6e 61 6c 0a 70 69 65 63 65 73 20 ditional.pieces
1800: 74 68 61 74 20 77 65 72 65 20 66 6f 75 6e 64 20 that were found
1810: 69 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 in the original
1820: 54 63 6c 6b 69 74 3a 0a 09 31 2e 20 54 6b 20 28 Tclkit:..1. Tk (
1830: 64 79 6e 61 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b dynamically link
1840: 65 64 29 0a 09 32 2e 20 49 74 63 6c 20 28 64 79 ed)..2. Itcl (dy
1850: 6e 61 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b 65 64 namically linked
1860: 29 0a 0a 54 68 65 20 73 6f 75 72 63 65 20 63 6f )..The source co
1870: 64 65 20 66 6f 72 20 74 68 65 73 65 20 70 69 65 de for these pie
1880: 63 65 73 20 61 72 65 20 64 6f 77 6e 6c 6f 61 64 ces are download
1890: 65 64 2c 20 63 6f 6d 70 69 6c 65 64 2c 20 61 6e ed, compiled, an
18a0: 64 20 6c 69 6e 6b 65 64 2c 20 61 6e 64 20 74 68 d linked, and th
18b0: 65 0a 64 61 74 61 62 61 73 65 20 63 6f 6e 74 61 e.database conta
18c0: 69 6e 69 6e 67 20 74 68 65 20 61 70 70 72 6f 70 ining the approp
18d0: 72 69 61 74 65 20 66 69 6c 65 73 79 73 74 65 6d riate filesystem
18e0: 20 64 61 74 61 20 69 73 20 63 72 65 61 74 65 64 data is created
18f0: 2e 20 20 57 68 61 74 20 73 65 74 73 0a 74 68 69 . What sets.thi
1900: 73 20 70 72 6f 6a 65 63 74 20 61 70 61 72 74 20 s project apart
1910: 66 72 6f 6d 20 6f 74 68 65 72 20 73 69 6d 69 6c from other simil
1920: 61 72 20 70 72 6f 6a 65 63 74 73 20 69 73 20 74 ar projects is t
1930: 68 61 74 3a 0a 09 31 2e 20 49 74 20 61 74 74 65 hat:..1. It atte
1940: 6d 70 74 73 20 74 6f 20 62 65 20 6d 6f 64 75 6c mpts to be modul
1950: 61 72 3b 0a 09 32 2e 20 49 74 20 73 75 70 70 6f ar;..2. It suppo
1960: 72 74 73 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c rts cross-compil
1970: 69 6e 67 3b 0a 09 33 2e 20 49 74 20 64 6f 77 6e ing;..3. It down
1980: 6c 6f 61 64 73 20 74 68 65 20 73 6f 75 72 63 65 loads the source
1990: 20 66 72 6f 6d 20 74 68 65 69 72 20 6f 72 69 67 from their orig
19a0: 69 6e 61 6c 20 72 65 70 6f 73 69 74 6f 72 69 65 inal repositorie
19b0: 73 3b 0a 09 34 2e 20 49 74 20 61 6c 6c 6f 77 73 s;..4. It allows
19c0: 20 79 6f 75 20 74 6f 20 73 70 65 63 69 66 79 20 you to specify
19d0: 61 6e 20 61 72 62 69 74 72 61 72 79 20 76 65 72 an arbitrary ver
19e0: 73 69 6f 6e 20 6f 66 20 54 63 6c 20 28 69 6e 63 sion of Tcl (inc
19f0: 6c 75 64 69 6e 67 0a 09 20 20 20 43 56 53 29 3b luding.. CVS);
1a00: 20 61 6e 64 0a 09 35 2e 20 49 74 20 75 73 65 73 and..5. It uses
1a10: 20 47 4e 55 20 41 75 74 6f 63 6f 6e 66 20 73 63 GNU Autoconf sc
1a20: 72 69 70 74 73 20 66 6f 72 20 63 6f 6d 70 69 6c ripts for compil
1a30: 69 6e 67 20 74 68 65 20 70 61 72 74 20 6f 66 20 ing the part of
1a40: 74 68 65 20 54 63 6c 6b 69 74 0a 09 20 20 20 74 the Tclkit.. t
1a50: 68 61 74 20 62 72 69 6e 67 73 20 74 68 65 20 77 hat brings the w
1a60: 68 6f 6c 65 20 74 68 69 6e 67 20 74 6f 67 65 74 hole thing toget
1a70: 68 65 72 20 28 74 68 65 20 4b 69 74 73 68 29 0a her (the Kitsh).
1a80: 0a 54 6f 20 61 63 63 6f 6d 70 6c 69 73 68 20 74 .To accomplish t
1a90: 68 65 73 65 20 67 6f 61 6c 73 20 74 68 65 20 66 hese goals the f
1aa0: 6f 6c 6c 6f 77 69 6e 67 20 6d 65 63 68 61 6e 69 ollowing mechani
1ab0: 73 6d 73 20 61 72 65 20 69 6e 20 70 6c 61 63 65 sms are in place
1ac0: 3a 0a 09 31 2e 20 54 68 65 20 74 6f 70 2d 6c 65 :..1. The top-le
1ad0: 76 65 6c 20 22 6b 69 74 63 72 65 61 74 6f 72 22 vel "kitcreator"
1ae0: 20 73 63 72 69 70 74 3b 20 61 6e 64 0a 09 32 2e script; and..2.
1af0: 20 50 65 72 2d 70 72 6f 6a 65 63 74 20 73 75 62 Per-project sub
1b00: 64 69 72 65 63 74 6f 72 69 65 73 2c 20 65 61 63 directories, eac
1b10: 68 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 22 h containing a "
1b20: 62 75 69 6c 64 2e 73 68 22 20 73 63 72 69 70 74 build.sh" script
1b30: 0a 0a 54 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 ..The top-level
1b40: 22 6b 69 74 63 72 65 61 74 6f 72 22 20 73 63 72 "kitcreator" scr
1b50: 69 70 74 20 69 73 20 76 65 72 79 20 73 69 6d 70 ipt is very simp
1b60: 6c 65 2e 20 20 49 74 73 20 6f 6e 6c 79 20 6a 6f le. Its only jo
1b70: 62 20 69 73 20 74 6f 0a 69 6e 74 65 72 70 72 65 b is to.interpre
1b80: 74 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 61 t command line a
1b90: 72 67 75 6d 65 6e 74 73 2c 20 61 6e 64 20 63 61 rguments, and ca
1ba0: 6c 6c 20 74 68 65 20 70 65 72 2d 70 72 6f 6a 65 ll the per-proje
1bb0: 63 74 20 22 62 75 69 6c 64 2e 73 68 22 20 73 63 ct "build.sh" sc
1bc0: 72 69 70 74 73 2e 0a 46 6f 72 20 74 68 65 20 22 ripts..For the "
1bd0: 74 63 6c 22 20 70 72 6f 6a 65 63 74 20 69 74 20 tcl" project it
1be0: 61 6c 73 6f 20 66 69 6e 64 73 20 74 68 65 20 61 also finds the a
1bf0: 70 70 72 6f 70 72 69 61 74 65 20 22 74 63 6c 43 ppropriate "tclC
1c00: 6f 6e 66 69 67 2e 73 68 22 20 28 61 6e 64 20 73 onfig.sh" (and s
1c10: 74 6f 72 65 73 0a 74 68 69 73 20 70 61 74 68 20 tores.this path
1c20: 69 6e 20 54 43 4c 43 4f 4e 46 49 47 44 49 52 29 in TCLCONFIGDIR)
1c30: 20 74 6f 20 65 6e 61 62 6c 65 20 73 75 62 73 65 to enable subse
1c40: 71 75 65 6e 74 20 62 75 69 6c 64 20 73 63 72 69 quent build scri
1c50: 70 74 73 20 74 6f 20 66 69 6e 64 20 74 68 65 0a pts to find the.
1c60: 61 70 70 72 6f 70 72 69 61 74 65 20 54 63 6c 20 appropriate Tcl
1c70: 74 6f 20 6c 69 6e 6b 20 61 67 61 69 6e 73 74 2e to link against.
1c80: 0a 0a 54 68 65 20 70 65 72 2d 70 72 6f 6a 65 63 ..The per-projec
1c90: 74 20 22 62 75 69 6c 64 2e 73 68 22 20 73 63 72 t "build.sh" scr
1ca0: 69 70 74 73 20 61 72 65 20 65 6e 74 69 72 65 6c ipts are entirel
1cb0: 79 20 61 75 74 6f 6e 6f 6d 6f 75 73 2e 20 20 54 y autonomous. T
1cc0: 68 65 79 20 61 72 65 0a 72 65 73 70 6f 6e 73 69 hey are.responsi
1cd0: 62 6c 65 20 66 6f 72 20 64 6f 77 6e 6c 6f 61 64 ble for download
1ce0: 69 6e 67 20 74 68 65 20 73 6f 75 72 63 65 20 63 ing the source c
1cf0: 6f 64 65 20 66 6f 72 20 74 68 65 20 61 70 70 72 ode for the appr
1d00: 6f 70 72 69 61 74 65 20 76 65 72 73 69 6f 6e 20 opriate version
1d10: 74 68 61 74 0a 77 69 6c 6c 20 63 6f 6d 70 69 6c that.will compil
1d20: 65 20 61 6e 64 20 6c 69 6e 6b 20 61 67 61 69 6e e and link again
1d30: 73 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 st the current v
1d40: 65 72 73 69 6f 6e 20 6f 66 20 54 63 6c 20 28 75 ersion of Tcl (u
1d50: 73 65 72 20 72 65 71 75 65 73 74 65 64 0a 76 65 ser requested.ve
1d60: 72 73 69 6f 6e 20 63 61 6e 20 62 65 20 66 6f 75 rsion can be fou
1d70: 6e 64 20 69 6e 20 22 54 43 4c 56 45 52 53 22 2c nd in "TCLVERS",
1d80: 20 77 68 69 6c 65 20 74 68 65 20 61 63 74 75 61 while the actua
1d90: 6c 20 76 65 72 73 69 6f 6e 20 6d 75 73 74 20 62 l version must b
1da0: 65 20 72 65 71 75 65 73 74 65 64 0a 66 72 6f 6d e requested.from
1db0: 20 74 68 65 20 22 74 63 6c 43 6f 6e 66 69 67 2e the "tclConfig.
1dc0: 73 68 22 20 73 63 72 69 70 74 29 2c 20 63 6f 6d sh" script), com
1dd0: 70 69 6c 69 6e 67 20 69 74 2c 20 69 6e 73 74 61 piling it, insta
1de0: 6c 6c 69 6e 67 20 61 20 66 75 6e 63 74 69 6f 6e lling a function
1df0: 61 6c 20 63 6f 70 79 0a 69 6e 74 6f 20 74 68 65 al copy.into the
1e00: 20 70 65 72 2d 70 72 6f 6a 65 63 74 20 22 69 6e per-project "in
1e10: 73 74 22 20 64 69 72 65 63 74 6f 72 79 2c 20 61 st" directory, a
1e20: 6e 64 20 69 6e 73 74 61 6c 6c 69 6e 67 20 61 6e nd installing an
1e30: 79 74 68 69 6e 67 20 74 68 61 74 20 6e 65 65 64 ything that need
1e40: 73 20 74 6f 0a 62 65 20 69 6e 20 74 68 65 20 54 s to.be in the T
1e50: 63 6c 6b 69 74 27 73 20 56 46 53 20 72 6f 6f 74 clkit's VFS root
1e60: 20 69 6e 74 6f 20 74 68 65 20 70 65 72 2d 70 72 into the per-pr
1e70: 6f 6a 65 63 74 20 22 6f 75 74 22 20 64 69 72 65 oject "out" dire
1e80: 63 74 6f 72 79 2e 0a 0a 54 68 65 20 65 78 63 65 ctory...The exce
1e90: 70 74 69 6f 6e 20 74 6f 20 74 68 69 73 20 69 73 ption to this is
1ea0: 20 74 68 65 20 22 6b 69 74 73 68 22 20 61 6e 64 the "kitsh" and
1eb0: 20 22 6b 69 74 64 6c 6c 22 20 70 72 6f 6a 65 63 "kitdll" projec
1ec0: 74 73 2e 20 20 54 68 65 79 20 61 72 65 20 74 68 ts. They are th
1ed0: 65 20 67 6c 75 65 0a 74 68 61 74 20 62 69 6e 64 e glue.that bind
1ee0: 73 20 61 6c 6c 20 74 68 65 20 69 6e 64 69 76 69 s all the indivi
1ef0: 64 75 61 6c 20 70 72 6f 6a 65 63 74 73 20 74 6f dual projects to
1f00: 67 65 74 68 65 72 20 69 6e 74 6f 20 61 20 73 69 gether into a si
1f10: 6e 67 6c 65 20 65 78 65 63 75 74 61 62 6c 65 2e ngle executable.
1f20: 20 20 49 74 73 0a 62 75 69 6c 64 20 73 63 72 69 Its.build scri
1f30: 70 74 20 64 6f 65 73 20 6e 6f 74 20 63 72 65 61 pt does not crea
1f40: 74 65 20 61 6e 20 22 69 6e 73 74 22 20 6f 72 20 te an "inst" or
1f50: 61 6e 20 22 6f 75 74 22 20 64 69 72 65 63 74 6f an "out" directo
1f60: 72 79 20 62 65 63 61 75 73 65 20 69 74 20 69 73 ry because it is
1f70: 20 6e 6f 74 0a 61 20 6c 69 62 72 61 72 79 2e 20 not.a library.
1f80: 20 49 6e 73 74 65 61 64 2c 20 69 74 20 63 6f 6c Instead, it col
1f90: 6c 65 63 74 73 20 61 6c 6c 20 74 68 65 20 6f 74 lects all the ot
1fa0: 68 65 72 20 70 72 6f 6a 65 63 74 27 73 20 22 6f her project's "o
1fb0: 75 74 22 20 64 69 72 65 63 74 6f 72 69 65 73 0a ut" directories.
1fc0: 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20 64 69 into a single di
1fd0: 72 65 63 74 6f 72 79 20 28 73 74 61 72 70 61 63 rectory (starpac
1fe0: 6b 2e 76 66 73 29 2c 20 61 73 20 77 65 6c 6c 20 k.vfs), as well
1ff0: 61 20 73 74 61 74 69 63 20 66 69 6c 65 20 28 62 a static file (b
2000: 6f 6f 74 2e 74 63 6c 29 2e 0a 49 74 20 74 68 65 oot.tcl)..It the
2010: 6e 20 63 6f 6d 70 69 6c 65 73 20 74 68 65 20 73 n compiles the s
2020: 6f 75 72 63 65 20 63 6f 64 65 2c 20 61 6e 64 20 ource code, and
2030: 74 68 65 6e 20 69 6e 73 74 61 6c 6c 73 20 74 68 then installs th
2040: 65 20 56 46 53 20 6f 6e 74 6f 20 74 68 65 20 72 e VFS onto the r
2050: 65 73 75 6c 74 69 6e 67 0a 65 78 65 63 75 74 61 esulting.executa
2060: 62 6c 65 2e 20 20 54 68 65 20 56 46 53 20 69 73 ble. The VFS is
2070: 20 63 72 65 61 74 65 64 20 62 79 20 74 68 65 20 created by the
2080: 22 69 6e 73 74 61 6c 6c 76 66 73 2e 74 63 6c 22 "installvfs.tcl"
2090: 20 73 63 72 69 70 74 20 66 6f 72 20 4b 69 74 73 script for Kits
20a0: 68 2e 20 20 46 6f 72 0a 4b 69 74 44 4c 4c 20 74 h. For.KitDLL t
20b0: 68 65 20 56 46 53 20 69 73 20 63 72 65 61 74 65 he VFS is create
20c0: 64 20 62 79 20 22 64 69 72 32 63 2e 74 63 6c 22 d by "dir2c.tcl"
20d0: 2e 0a 0a 49 66 20 74 68 65 20 22 6d 6b 34 74 63 ...If the "mk4tc
20e0: 6c 22 20 70 72 6f 6a 65 63 74 20 66 61 69 6c 73 l" project fails
20f0: 20 74 6f 20 62 75 69 6c 64 20 28 6f 72 20 69 73 to build (or is
2100: 20 6e 6f 74 20 72 65 71 75 65 73 74 65 64 20 74 not requested t
2110: 6f 20 62 65 20 62 75 69 6c 74 29 2c 0a 74 68 65 o be built),.the
2120: 20 72 65 73 74 20 6f 66 20 74 68 65 20 70 72 6f rest of the pro
2130: 6a 65 63 74 20 77 69 6c 6c 20 62 65 20 62 75 69 ject will be bui
2140: 6c 74 20 75 73 69 6e 67 20 7a 69 70 20 66 69 6c lt using zip fil
2150: 65 73 20 69 6e 73 74 65 61 64 20 6f 66 20 4d 65 es instead of Me
2160: 74 61 6b 69 74 0a 64 61 74 61 62 61 73 65 73 2e takit.databases.
2170: 0a 0a 54 6f 20 63 72 65 61 74 65 20 74 68 65 20 ..To create the
2180: 73 74 6f 72 61 67 65 20 64 61 74 61 62 61 73 65 storage database
2190: 2c 20 6f 6e 65 20 6f 66 20 74 77 6f 20 54 63 6c , one of two Tcl
21a0: 6b 69 74 73 20 69 73 20 75 73 65 64 20 28 74 72 kits is used (tr
21b0: 69 65 64 20 69 6e 20 74 68 69 73 0a 6f 72 64 65 ied in this.orde
21c0: 72 29 3a 0a 09 31 2e 20 54 68 65 20 54 63 6c 6b r):..1. The Tclk
21d0: 69 74 20 73 70 65 63 69 66 69 65 64 20 62 79 20 it specified by
21e0: 74 68 65 20 54 43 4c 4b 49 54 20 65 6e 76 69 72 the TCLKIT envir
21f0: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 onment variable
2200: 28 6f 72 0a 09 20 20 20 22 74 63 6c 6b 69 74 22 (or.. "tclkit"
2210: 20 69 66 20 74 68 61 74 20 76 61 72 69 61 62 6c if that variabl
2220: 65 20 69 73 20 6e 6f 74 20 73 65 74 29 20 69 66 e is not set) if
2230: 20 69 74 20 69 73 20 66 75 6e 63 74 69 6f 6e 61 it is functiona
2240: 6c 3b 20 6f 72 0a 09 32 2e 20 54 68 65 20 62 75 l; or..2. The bu
2250: 69 6c 74 20 54 63 6c 6b 69 74 20 69 74 73 65 6c ilt Tclkit itsel
2260: 66 0a 0a 54 68 65 20 73 65 63 6f 6e 64 20 6d 65 f..The second me
2270: 74 68 6f 64 20 77 69 6c 6c 20 6e 6f 74 20 77 6f thod will not wo
2280: 72 6b 20 69 66 20 74 68 65 20 62 75 69 6c 74 20 rk if the built
2290: 54 63 6c 6b 69 74 20 69 73 20 6e 6f 74 20 65 78 Tclkit is not ex
22a0: 65 63 75 74 61 62 6c 65 20 6f 6e 20 74 68 65 0a ecutable on the.
22b0: 63 75 72 72 65 6e 74 20 70 6c 61 74 66 6f 72 6d current platform
22c0: 20 28 69 2e 65 2e 2c 20 69 6e 20 74 68 65 20 63 (i.e., in the c
22d0: 61 73 65 20 6f 66 20 63 72 6f 73 73 2d 63 6f 6d ase of cross-com
22e0: 70 69 6c 61 74 69 6f 6e 29 20 61 6e 64 20 73 6f pilation) and so
22f0: 20 69 74 20 6d 61 79 20 62 65 0a 6e 65 63 65 73 it may be.neces
2300: 73 61 72 79 20 74 6f 20 62 6f 6f 74 73 74 72 61 sary to bootstra
2310: 70 20 61 20 72 75 6e 6e 61 62 6c 65 20 54 63 6c p a runnable Tcl
2320: 6b 69 74 20 66 69 72 73 74 2e 0a 0a 4b 69 74 44 kit first...KitD
2330: 4c 4c 20 6d 6f 75 6e 74 73 20 74 68 65 20 56 46 LL mounts the VF
2340: 53 20 66 6f 72 20 65 76 65 72 79 20 69 6e 74 65 S for every inte
2350: 72 70 72 65 74 65 72 20 74 68 61 74 20 63 61 6c rpreter that cal
2360: 6c 73 20 54 63 6c 5f 49 6e 69 74 28 29 2e 20 20 ls Tcl_Init().
2370: 54 68 65 20 73 79 73 74 65 6d 0a 56 46 53 20 74 The system.VFS t
2380: 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20 61 hat is created a
2390: 74 20 62 75 69 6c 64 20 74 69 6d 65 20 69 73 20 t build time is
23a0: 6d 6f 75 6e 74 65 64 20 61 74 20 2f 2e 4b 49 54 mounted at /.KIT
23b0: 44 4c 4c 5f 54 43 4c 2e 20 20 41 64 64 69 74 69 DLL_TCL. Additi
23c0: 6f 6e 61 6c 6c 79 2c 0a 69 66 20 74 68 65 72 65 onally,.if there
23d0: 20 69 73 20 61 20 5a 49 50 20 66 69 6c 65 20 61 is a ZIP file a
23e0: 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 44 ppended to the D
23f0: 4c 4c 20 69 74 20 77 69 6c 6c 20 62 65 20 6d 6f LL it will be mo
2400: 75 6e 74 65 64 20 61 74 20 2f 2e 4b 49 54 44 4c unted at /.KITDL
2410: 4c 5f 55 53 45 52 0a 61 6e 64 20 69 66 20 74 68 L_USER.and if th
2420: 65 72 65 20 69 73 20 61 20 5a 49 50 20 66 69 6c ere is a ZIP fil
2430: 65 20 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 e appended to th
2440: 65 20 65 78 65 63 75 74 61 62 6c 65 20 69 74 20 e executable it
2450: 77 69 6c 6c 20 62 65 20 6d 6f 75 6e 74 65 64 20 will be mounted
2460: 61 74 0a 2f 2e 4b 49 54 44 4c 4c 5f 41 50 50 2e at./.KITDLL_APP.
2470: 20 20 41 6c 6c 20 56 46 53 65 73 20 74 68 61 74 All VFSes that
2480: 20 61 72 65 20 6d 6f 75 6e 74 65 64 20 68 61 76 are mounted hav
2490: 65 20 74 68 65 20 22 6c 69 62 22 20 73 75 62 2d e the "lib" sub-
24a0: 64 69 72 65 63 74 6f 72 79 20 61 70 70 65 6e 64 directory append
24b0: 65 64 0a 74 6f 20 74 68 65 20 69 6e 74 65 72 70 ed.to the interp
24c0: 72 65 74 65 72 73 20 22 61 75 74 6f 5f 70 61 74 reters "auto_pat
24d0: 68 22 20 76 61 72 69 61 62 6c 65 2e 0a h" variable..