Artifact 8f0b451b52a53f89d45f4929dce34fbb3ceb8d4c:
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 4b 69 74 44 4c 4c 20 77 69 74 68 6f 75 74 20 KitDLL without
0740: 4d 65 74 61 6b 69 74 20 73 75 70 70 6f 72 74 20 Metakit support
0750: 28 77 69 6c 6c 20 6e 6f 74 20 63 72 65 61 74 65 (will not create
0760: 20 61 20 54 63 6c 6b 69 74 0a 09 20 20 20 20 62 a Tclkit.. b
0770: 69 6e 61 72 79 2c 20 6a 75 73 74 20 74 68 65 20 inary, just the
0780: 6c 69 62 72 61 72 79 29 3a 0a 09 09 61 2e 20 24 library):...a. $
0790: 20 4b 49 54 43 52 45 41 54 4f 52 5f 50 4b 47 53 KITCREATOR_PKGS
07a0: 3d 27 74 6b 20 69 74 63 6c 20 6b 69 74 64 6c 6c ='tk itcl kitdll
07b0: 27 0a 09 09 62 2e 20 24 20 65 78 70 6f 72 74 20 '...b. $ export
07c0: 4b 49 54 43 52 45 41 54 4f 52 5f 50 4b 47 53 0a KITCREATOR_PKGS.
07d0: 09 09 63 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61 ..c. $ ./kitcrea
07e0: 74 6f 72 0a 0a 45 6e 76 69 72 6f 6e 6d 65 6e 74 tor..Environment
07f0: 20 76 61 72 69 61 62 6c 65 73 3a 0a 09 31 2e 20 variables:..1.
0800: 4d 41 4b 45 0a 09 09 53 70 65 63 69 66 69 65 73 MAKE...Specifies
0810: 20 74 68 65 20 74 6f 6f 6c 20 79 6f 75 20 77 69 the tool you wi
0820: 73 68 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 sh to be called
0830: 74 6f 20 62 75 69 6c 64 20 74 61 72 67 65 74 73 to build targets
0840: 0a 09 09 66 72 6f 6d 20 61 20 4d 61 6b 65 66 69 ...from a Makefi
0850: 6c 65 2e 20 20 54 68 69 73 20 73 63 72 69 70 74 le. This script
0860: 20 69 73 20 67 65 6e 65 72 61 6c 6c 79 20 6d 6f is generally mo
0870: 72 65 20 77 65 6c 6c 20 74 65 73 74 65 64 0a 09 re well tested..
0880: 09 77 69 74 68 20 47 4e 55 20 4d 61 6b 65 2e 0a .with GNU Make..
0890: 0a 09 32 2e 20 50 41 54 43 48 0a 09 09 53 70 65 ..2. PATCH...Spe
08a0: 63 69 66 69 65 73 20 74 68 65 20 74 6f 6f 6c 20 cifies the tool
08b0: 79 6f 75 20 77 69 73 68 20 74 6f 20 62 65 20 63 you wish to be c
08c0: 61 6c 6c 65 64 20 74 6f 20 61 70 70 6c 79 20 75 alled to apply u
08d0: 6e 69 66 69 65 64 0a 09 09 64 69 66 66 20 70 61 nified...diff pa
08e0: 74 63 68 65 73 2e 20 20 54 68 69 73 20 73 63 72 tches. This scr
08f0: 69 70 74 20 69 73 20 67 65 6e 65 72 61 6c 6c 79 ipt is generally
0900: 20 6d 6f 72 65 20 77 65 6c 6c 20 74 65 73 74 65 more well teste
0910: 64 20 77 69 74 68 0a 09 09 47 4e 55 20 50 61 74 d with...GNU Pat
0920: 63 68 2e 20 0a 0a 09 33 2e 20 54 43 4c 4b 49 54 ch. ...3. TCLKIT
0930: 0a 09 09 53 70 65 63 69 66 79 20 74 68 65 20 70 ...Specify the p
0940: 61 74 68 20 74 6f 20 61 20 54 63 6c 6b 69 74 20 ath to a Tclkit
0950: 74 68 61 74 20 69 73 20 72 75 6e 6e 61 62 6c 65 that is runnable
0960: 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 0a on the current.
0970: 09 09 73 79 73 74 65 6d 2e 20 20 54 68 65 20 64 ..system. The d
0980: 65 66 61 75 6c 74 20 69 73 20 22 74 63 6c 6b 69 efault is "tclki
0990: 74 22 2e 20 20 41 20 77 6f 72 6b 69 6e 67 20 74 t". A working t
09a0: 63 6c 6b 69 74 20 69 73 20 72 65 71 75 69 72 65 clkit is require
09b0: 64 0a 09 09 66 6f 72 20 63 72 6f 73 73 2d 63 6f d...for cross-co
09c0: 6d 70 69 6c 69 6e 67 20 54 63 6c 6b 69 74 73 2e mpiling Tclkits.
09d0: 0a 0a 09 34 2e 20 53 54 41 54 49 43 54 4b 0a 09 ...4. STATICTK..
09e0: 09 53 70 65 63 69 66 79 20 74 68 69 73 20 61 73 .Specify this as
09f0: 20 22 31 22 20 74 6f 20 73 74 61 74 69 63 61 6c "1" to statical
0a00: 6c 79 20 6c 69 6e 6b 20 74 6f 20 54 6b 2e 20 20 ly link to Tk.
0a10: 54 68 65 20 64 65 66 61 75 6c 74 0a 09 09 61 63 The default...ac
0a20: 74 69 6f 6e 20 6f 6e 20 6d 6f 73 74 20 70 6c 61 tion on most pla
0a30: 74 66 6f 72 6d 73 20 69 73 20 74 6f 20 64 79 6e tforms is to dyn
0a40: 61 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b 20 74 6f amically link to
0a50: 20 54 6b 2e 20 20 57 68 65 6e 0a 09 09 62 75 69 Tk. When...bui
0a60: 6c 64 69 6e 67 20 4b 69 74 44 4c 4c 2c 20 53 54 lding KitDLL, ST
0a70: 41 54 49 43 54 4b 20 69 73 20 22 31 22 20 62 79 ATICTK is "1" by
0a80: 20 64 65 66 61 75 6c 74 2e 20 20 49 66 20 79 6f default. If yo
0a90: 75 20 77 61 6e 74 20 74 6f 0a 09 09 65 6e 61 62 u want to...enab
0aa0: 6c 65 20 64 79 6e 61 6d 69 63 20 6c 69 6e 6b 69 le dynamic linki
0ab0: 6e 67 20 6f 66 20 54 6b 20 77 69 74 68 20 4b 69 ng of Tk with Ki
0ac0: 74 44 4c 4c 20 79 6f 75 20 77 69 6c 6c 20 68 61 tDLL you will ha
0ad0: 76 65 20 74 6f 0a 09 09 73 70 65 63 69 66 79 20 ve to...specify
0ae0: 74 68 69 73 20 61 73 20 22 2d 31 22 2e 0a 0a 09 this as "-1"....
0af0: 35 2e 20 53 54 41 54 49 43 4d 4b 34 0a 09 09 53 5. STATICMK4...S
0b00: 70 65 63 69 66 79 20 74 68 69 73 20 61 73 20 22 pecify this as "
0b10: 30 22 20 74 6f 20 61 74 74 65 6d 70 74 20 74 6f 0" to attempt to
0b20: 20 63 72 65 61 74 65 20 63 72 65 61 74 65 20 74 create create t
0b30: 68 65 20 22 6d 6b 34 74 63 6c 22 0a 09 09 70 72 he "mk4tcl"...pr
0b40: 6f 6a 65 63 74 20 61 73 20 61 20 73 68 61 72 65 oject as a share
0b50: 64 20 6f 62 6a 65 63 74 2e 20 20 49 66 20 74 68 d object. If th
0b60: 69 73 20 66 61 69 6c 73 2c 20 69 74 20 77 69 6c is fails, it wil
0b70: 6c 20 66 61 6c 6c 20 62 61 63 6b 0a 09 09 74 6f l fall back...to
0b80: 20 62 75 69 6c 64 69 6e 67 20 73 74 61 74 69 63 building static
0b90: 61 6c 6c 79 2e 20 20 53 70 65 63 69 66 79 20 69 ally. Specify i
0ba0: 74 20 61 73 20 22 2d 31 22 20 74 6f 20 66 6f 72 t as "-1" to for
0bb0: 63 65 20 62 75 69 6c 64 69 6e 67 0a 09 09 69 74 ce building...it
0bc0: 20 61 73 20 61 20 73 68 61 72 65 64 20 6f 62 6a as a shared obj
0bd0: 65 63 74 2e 20 20 41 6e 79 20 6f 74 68 65 72 20 ect. Any other
0be0: 76 61 6c 75 65 2c 20 69 6e 63 6c 75 64 69 6e 67 value, including
0bf0: 20 62 65 69 6e 67 20 75 6e 73 65 74 0a 09 09 72 being unset...r
0c00: 65 73 75 6c 74 73 20 69 6e 20 22 6d 6b 34 74 63 esults in "mk4tc
0c10: 6c 22 20 62 65 69 6e 67 20 62 75 69 6c 74 20 61 l" being built a
0c20: 6e 64 20 6c 69 6e 6b 65 64 20 73 74 61 74 69 63 nd linked static
0c30: 61 6c 6c 79 2e 20 20 4b 69 74 44 49 4c 4c 0a 09 ally. KitDILL..
0c40: 09 73 65 74 73 20 74 68 69 73 20 74 6f 20 76 61 .sets this to va
0c50: 72 69 61 62 6c 65 20 74 6f 20 22 30 22 2e 20 20 riable to "0".
0c60: 49 66 20 4d 65 74 61 6b 69 74 34 20 69 73 20 62 If Metakit4 is b
0c70: 75 69 6c 74 20 73 68 61 72 65 64 2c 20 69 74 0a uilt shared, it.
0c80: 09 09 63 61 6e 6e 6f 74 20 62 65 20 75 73 65 64 ..cannot be used
0c90: 20 66 6f 72 20 74 68 65 20 6b 69 74 20 73 74 6f for the kit sto
0ca0: 72 61 67 65 20 66 6f 72 20 54 63 6c 6b 69 74 2e rage for Tclkit.
0cb0: 0a 0a 09 36 2e 20 53 54 52 49 50 0a 09 09 53 70 ...6. STRIP...Sp
0cc0: 65 63 69 66 69 65 73 20 74 68 65 20 74 6f 6f 6c ecifies the tool
0cd0: 20 79 6f 75 20 77 69 73 68 20 74 6f 20 62 65 20 you wish to be
0ce0: 63 61 6c 6c 65 64 20 74 6f 20 73 74 72 69 70 20 called to strip
0cf0: 6f 62 6a 65 63 74 20 66 69 6c 65 73 2c 0a 09 09 object files,...
0d00: 61 72 63 68 69 76 65 73 2c 20 61 6e 64 20 73 68 archives, and sh
0d10: 61 72 65 64 20 6f 62 6a 65 63 74 73 2e 20 20 54 ared objects. T
0d20: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 22 73 he default is "s
0d30: 74 72 69 70 22 2e 20 20 59 6f 75 0a 09 09 73 68 trip". You...sh
0d40: 6f 75 6c 64 20 70 72 6f 62 61 62 6c 79 20 73 65 ould probably se
0d50: 74 20 74 68 69 73 20 69 66 20 79 6f 75 20 61 72 t this if you ar
0d60: 65 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c 69 6e e cross-compilin
0d70: 67 2e 0a 0a 09 37 2e 20 4b 49 54 43 52 45 41 54 g....7. KITCREAT
0d80: 4f 52 5f 50 4b 47 53 0a 09 09 53 70 65 63 69 66 OR_PKGS...Specif
0d90: 79 20 77 68 69 63 68 20 6e 6f 6e 2d 72 65 71 75 y which non-requ
0da0: 69 72 65 64 20 70 61 63 6b 61 67 65 73 20 74 6f ired packages to
0db0: 20 62 75 69 6c 64 2e 20 20 54 68 65 20 64 65 66 build. The def
0dc0: 61 75 6c 74 20 6c 69 73 74 0a 09 09 69 73 3a 0a ault list...is:.
0dd0: 09 09 09 74 6b 20 69 74 63 6c 20 6d 6b 34 74 63 ...tk itcl mk4tc
0de0: 6c 0a 0a 09 09 49 66 20 6d 6b 34 74 63 6c 20 69 l....If mk4tcl i
0df0: 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 20 61 20 s not present a
0e00: 5a 69 70 2d 62 61 73 65 64 20 73 74 6f 72 61 67 Zip-based storag
0e10: 65 20 6d 65 63 68 61 6e 69 73 6d 20 77 69 6c 6c e mechanism will
0e20: 20 62 65 0a 09 09 75 73 65 64 20 69 6e 73 74 65 be...used inste
0e30: 61 64 2e 20 20 54 6f 20 73 70 65 63 69 66 79 20 ad. To specify
0e40: 74 68 61 74 20 74 68 65 20 64 65 66 61 75 6c 74 that the default
0e50: 20 62 65 20 75 73 65 64 2c 20 64 6f 20 6e 6f 74 be used, do not
0e60: 20 73 65 74 0a 09 09 74 68 69 73 20 6f 72 20 73 set...this or s
0e70: 65 74 20 69 74 20 74 6f 20 74 68 65 20 65 6d 70 et it to the emp
0e80: 74 79 20 73 74 72 69 6e 67 2e 20 20 54 6f 20 73 ty string. To s
0e90: 70 65 63 69 66 79 20 74 68 61 74 20 6e 6f 0a 09 pecify that no..
0ea0: 09 6e 6f 6e 2d 72 65 71 75 69 72 65 64 20 70 61 .non-required pa
0eb0: 63 6b 61 67 65 73 20 62 65 20 62 75 69 6c 74 2c ckages be built,
0ec0: 20 73 65 74 20 69 74 20 74 6f 20 61 20 73 74 72 set it to a str
0ed0: 69 6e 67 20 74 68 61 74 0a 09 09 63 6f 6e 74 61 ing that...conta
0ee0: 69 6e 73 20 6f 6e 6c 79 20 77 68 69 74 65 20 73 ins only white s
0ef0: 70 61 63 65 2e 0a 0a 09 09 49 66 20 22 6b 69 74 pace.....If "kit
0f00: 64 6c 6c 22 20 69 73 20 73 70 65 63 69 66 69 65 dll" is specifie
0f10: 64 20 69 6e 20 74 68 65 20 6c 69 73 74 20 74 68 d in the list th
0f20: 65 20 74 61 72 67 65 74 20 62 65 63 6f 6d 65 73 e target becomes
0f30: 20 4b 69 74 44 4c 4c 0a 09 09 61 6e 64 20 6e 6f KitDLL...and no
0f40: 20 54 63 6c 6b 69 74 20 77 69 6c 6c 20 62 75 69 Tclkit will bui
0f50: 6c 74 2c 20 62 75 74 20 69 6e 73 74 65 61 64 20 lt, but instead
0f60: 6c 69 62 74 63 6c 6b 69 74 2e 0a 0a 09 38 2e 20 libtclkit....8.
0f70: 4b 49 54 43 52 45 41 54 4f 52 5f 4d 49 4e 45 4e KITCREATOR_MINEN
0f80: 43 4f 44 49 4e 47 53 0a 09 09 53 65 74 20 74 68 CODINGS...Set th
0f90: 69 73 20 76 61 72 69 61 62 6c 65 20 74 6f 20 61 is variable to a
0fa0: 20 6e 6f 6e 2d 65 6d 70 74 79 20 73 74 72 69 6e non-empty strin
0fb0: 67 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61 20 g to generate a
0fc0: 54 63 6c 6b 69 74 0a 09 09 77 69 74 68 6f 75 74 Tclkit...without
0fd0: 20 61 6c 6c 20 65 6e 63 6f 64 69 6e 67 73 2c 20 all encodings,
0fe0: 6f 6e 6c 79 20 69 6e 63 6c 75 64 69 6e 67 20 74 only including t
0ff0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 09 09 he following:...
1000: 09 61 73 63 69 69 2e 65 6e 63 20 63 70 31 32 35 .ascii.enc cp125
1010: 32 2e 65 6e 63 20 69 73 6f 38 38 35 39 2d 31 2e 2.enc iso8859-1.
1020: 65 6e 63 20 69 73 6f 38 38 35 39 2d 31 35 2e 65 enc iso8859-15.e
1030: 6e 63 0a 09 09 09 69 73 6f 38 38 35 39 2d 32 2e nc....iso8859-2.
1040: 65 6e 63 20 6b 6f 69 38 2d 72 2e 65 6e 63 20 6d enc koi8-r.enc m
1050: 61 63 52 6f 6d 61 6e 2e 65 6e 63 0a 0a 09 39 2e acRoman.enc...9.
1060: 20 4b 49 54 43 52 45 41 54 4f 52 5f 4d 49 4e 42 KITCREATOR_MINB
1070: 55 49 4c 44 0a 09 09 53 65 74 20 74 68 69 73 20 UILD...Set this
1080: 76 61 72 69 61 62 6c 65 20 74 6f 20 61 20 6e 6f variable to a no
1090: 6e 2d 65 6d 70 74 79 20 73 74 72 69 6e 67 20 74 n-empty string t
10a0: 6f 20 65 78 63 6c 75 64 65 20 75 6e 6e 65 63 65 o exclude unnece
10b0: 73 73 61 72 79 0a 09 09 70 61 63 6b 61 67 65 73 ssary...packages
10c0: 20 66 72 6f 6d 20 54 63 6c 20 62 75 69 6c 64 2e from Tcl build.
10d0: 20 20 54 68 69 73 20 65 78 63 6c 75 64 65 73 20 This excludes
10e0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 61 the following pa
10f0: 63 6b 61 67 65 73 3a 0a 09 09 09 74 63 6c 74 65 ckages:....tclte
1100: 73 74 0a 0a 4b 69 74 73 68 20 43 6f 6e 66 69 67 st..Kitsh Config
1110: 75 72 65 20 4f 70 74 69 6f 6e 73 3a 0a 09 31 2e ure Options:..1.
1120: 20 2d 2d 65 6e 61 62 6c 65 2d 6b 69 74 2d 73 74 --enable-kit-st
1130: 6f 72 61 67 65 3d 7b 7a 69 70 7c 6d 6b 34 7c 61 orage={zip|mk4|a
1140: 75 74 6f 7d 0a 09 09 53 70 65 63 69 66 79 20 77 uto}...Specify w
1150: 68 69 63 68 20 74 79 70 65 20 6f 66 20 73 74 6f hich type of sto
1160: 72 61 67 65 20 74 6f 20 75 73 65 20 77 69 74 68 rage to use with
1170: 20 74 68 65 20 54 63 6c 6b 69 74 2e 20 20 54 68 the Tclkit. Th
1180: 65 0a 09 09 64 65 66 61 75 6c 74 20 69 73 20 74 e...default is t
1190: 6f 20 61 75 74 6f 2d 64 65 74 65 63 74 2e 20 20 o auto-detect.
11a0: 41 75 74 6f 2d 64 65 74 65 63 74 69 6f 6e 20 75 Auto-detection u
11b0: 73 65 73 20 4d 6b 34 20 69 66 0a 09 09 61 76 61 ses Mk4 if...ava
11c0: 69 6c 61 62 6c 65 20 61 6e 64 20 62 75 69 6c 74 ilable and built
11d0: 20 73 74 61 74 69 63 61 6c 6c 79 2c 20 6f 74 68 statically, oth
11e0: 65 72 77 69 73 65 20 69 74 20 66 61 6c 6c 73 20 erwise it falls
11f0: 62 61 63 6b 20 74 6f 20 5a 69 70 2e 0a 0a 2d 2d back to Zip...--
1200: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1210: 2d 0a 4d 65 74 68 6f 64 20 6f 66 20 4f 70 65 72 -.Method of Oper
1220: 61 74 69 6f 6e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ation.----------
1230: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 53 75 6d 6d 61 72 ---------.Summar
1240: 79 3a 0a 09 31 2e 20 22 6b 69 74 63 72 65 61 74 y:..1. "kitcreat
1250: 6f 72 22 20 63 61 6c 6c 73 20 2a 2f 62 75 69 6c or" calls */buil
1260: 64 2e 73 68 0a 09 32 2e 20 2a 2f 62 75 69 6c 64 d.sh..2. */build
1270: 2e 73 68 20 64 6f 77 6e 6c 6f 61 64 73 20 61 6e .sh downloads an
1280: 64 20 63 6f 6d 70 69 6c 65 73 20 61 70 70 72 6f d compiles appro
1290: 70 72 69 61 74 65 20 73 6f 66 74 77 61 72 65 0a priate software.
12a0: 09 33 2e 20 2a 2f 62 75 69 6c 64 2e 73 68 20 69 .3. */build.sh i
12b0: 6e 73 74 61 6c 6c 73 20 73 6f 66 74 77 61 72 65 nstalls software
12c0: 20 69 6e 74 6f 20 22 69 6e 73 74 22 20 28 72 75 into "inst" (ru
12d0: 6e 2d 74 69 6d 65 20 2b 20 63 6f 6d 70 69 6c 65 n-time + compile
12e0: 2d 74 69 6d 65 29 0a 09 34 2e 20 2a 2f 62 75 69 -time)..4. */bui
12f0: 6c 64 2e 73 68 20 69 6e 73 74 61 6c 6c 73 20 72 ld.sh installs r
1300: 75 6e 2d 74 69 6d 65 20 73 6f 66 74 77 61 72 65 un-time software
1310: 20 69 6e 74 6f 20 22 6f 75 74 22 2c 20 74 68 69 into "out", thi
1320: 73 20 77 69 6c 6c 20 62 65 0a 09 20 20 20 69 6e s will be.. in
1330: 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 54 63 cluded in the Tc
1340: 6c 6b 69 74 20 61 73 20 69 66 20 69 74 20 77 65 lkit as if it we
1350: 72 65 20 74 68 65 20 72 6f 6f 74 20 64 69 72 65 re the root dire
1360: 63 74 6f 72 79 20 6f 66 20 74 68 65 0a 09 20 20 ctory of the..
1370: 20 54 63 6c 6b 69 74 20 28 63 6f 6d 62 69 6e 65 Tclkit (combine
1380: 64 20 77 69 74 68 20 6f 74 68 65 72 20 22 6f 75 d with other "ou
1390: 74 22 20 64 69 72 65 63 74 6f 72 69 65 73 29 0a t" directories).
13a0: 09 35 2e 20 6b 69 74 73 68 2f 62 75 69 6c 64 2e .5. kitsh/build.
13b0: 73 68 20 63 6f 6d 70 69 6c 65 73 20 61 20 22 6d sh compiles a "m
13c0: 61 69 6e 22 20 66 75 6e 63 74 69 6f 6e 20 61 6e ain" function an
13d0: 64 20 6c 69 6e 6b 73 20 61 6c 6c 20 74 68 65 20 d links all the
13e0: 62 75 69 6c 74 0a 09 20 20 20 6c 69 62 72 61 72 built.. librar
13f0: 69 65 73 20 74 6f 67 65 74 68 65 72 20 69 6e 74 ies together int
1400: 6f 20 61 6e 20 65 78 65 63 75 74 61 62 6c 65 0a o an executable.
1410: 09 36 2e 20 6b 69 74 73 68 2f 62 75 69 6c 64 2e .6. kitsh/build.
1420: 73 68 20 63 6f 6d 62 69 6e 65 73 20 61 6c 6c 20 sh combines all
1430: 74 68 65 20 22 6f 75 74 22 20 64 69 72 65 63 74 the "out" direct
1440: 6f 72 69 65 73 20 69 6e 74 6f 20 6f 6e 65 0a 09 ories into one..
1450: 37 2e 20 6b 69 74 73 68 2f 62 75 69 6c 64 2e 73 7. kitsh/build.s
1460: 68 20 63 72 65 61 74 65 73 20 61 20 4d 65 74 61 h creates a Meta
1470: 6b 69 74 20 6f 72 20 5a 69 70 20 64 61 74 61 62 kit or Zip datab
1480: 61 73 65 20 66 72 6f 6d 20 74 68 65 20 63 6f 6d ase from the com
1490: 62 69 6e 65 64 0a 09 20 20 20 64 69 72 65 63 74 bined.. direct
14a0: 6f 72 69 65 73 20 61 6e 64 20 61 70 70 65 6e 64 ories and append
14b0: 73 20 74 68 61 74 20 74 6f 20 74 68 65 20 63 6f s that to the co
14c0: 6d 70 69 6c 65 64 20 65 78 65 63 75 74 61 62 6c mpiled executabl
14d0: 65 20 75 73 69 6e 67 3a 0a 09 09 61 2e 20 41 20 e using:...a. A
14e0: 54 63 6c 6b 69 74 20 66 6f 75 6e 64 20 69 6e 20 Tclkit found in
14f0: 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 the environment
1500: 76 61 72 69 61 62 6c 65 20 22 54 43 4c 4b 49 54 variable "TCLKIT
1510: 22 20 28 74 63 6c 6b 69 74 0a 09 09 20 20 20 69 " (tclkit... i
1520: 66 20 75 6e 73 65 74 29 20 69 66 20 69 74 20 69 f unset) if it i
1530: 73 20 66 75 6e 63 74 69 6f 6e 61 6c 3b 20 6f 72 s functional; or
1540: 0a 09 09 62 2e 20 54 68 65 20 62 75 69 6c 74 20 ...b. The built
1550: 6b 69 74 20 69 74 73 65 6c 66 20 28 64 6f 65 73 kit itself (does
1560: 20 6e 6f 74 20 77 6f 72 6b 20 66 6f 72 20 63 72 not work for cr
1570: 6f 73 73 2d 63 6f 6d 70 69 6c 69 6e 67 29 0a 0a oss-compiling)..
1580: 44 65 74 61 69 6c 73 3a 0a 09 54 68 65 20 67 65 Details:..The ge
1590: 6e 65 72 61 6c 20 6d 65 63 68 61 6e 69 73 6d 20 neral mechanism
15a0: 74 68 61 74 20 65 6e 61 62 6c 65 73 20 61 20 54 that enables a T
15b0: 63 6c 6b 69 74 20 74 6f 20 6f 70 65 72 61 74 65 clkit to operate
15c0: 20 69 73 20 61 20 73 6d 61 6c 6c 20 54 63 6c 0a is a small Tcl.
15d0: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 72 initialization r
15e0: 6f 75 74 69 6e 65 20 6c 69 6e 6b 65 64 20 73 74 outine linked st
15f0: 61 74 69 63 61 6c 6c 79 20 74 6f 20 74 68 65 20 atically to the
1600: 63 6f 72 65 20 6c 69 62 72 61 72 69 65 73 20 6e core libraries n
1610: 65 65 64 65 64 20 74 6f 0a 6f 70 65 72 61 74 65 eeded to.operate
1620: 20 61 20 54 63 6c 20 69 6e 74 65 72 70 72 65 74 a Tcl interpret
1630: 65 72 2c 20 74 68 65 20 54 63 6c 20 56 46 53 20 er, the Tcl VFS
1640: 4c 61 79 65 72 2c 20 61 6e 64 20 61 20 64 61 74 Layer, and a dat
1650: 61 62 61 73 65 2d 62 61 63 6b 65 64 20 28 4d 65 abase-backed (Me
1660: 74 61 6b 69 74 29 0a 56 69 72 74 75 61 6c 20 46 takit).Virtual F
1670: 69 6c 65 20 53 79 73 74 65 6d 20 74 68 61 74 20 ile System that
1680: 69 73 20 61 70 70 65 6e 64 65 64 20 74 6f 20 74 is appended to t
1690: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 65 78 he end of the ex
16a0: 65 63 75 74 61 62 6c 65 2e 0a 0a 54 68 69 73 20 ecutable...This
16b0: 70 72 6f 6a 65 63 74 20 62 72 69 6e 67 73 20 74 project brings t
16c0: 6f 67 65 74 68 65 72 20 61 6c 6c 20 6f 66 20 74 ogether all of t
16d0: 68 65 20 72 65 71 75 69 72 65 64 20 70 69 65 63 he required piec
16e0: 65 73 2c 20 70 6c 75 73 20 73 6f 6d 65 20 61 64 es, plus some ad
16f0: 64 69 74 69 6f 6e 61 6c 0a 70 69 65 63 65 73 20 ditional.pieces
1700: 74 68 61 74 20 77 65 72 65 20 66 6f 75 6e 64 20 that were found
1710: 69 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 in the original
1720: 54 63 6c 6b 69 74 3a 0a 09 31 2e 20 54 6b 20 28 Tclkit:..1. Tk (
1730: 64 79 6e 61 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b dynamically link
1740: 65 64 29 0a 09 32 2e 20 49 74 63 6c 20 28 64 79 ed)..2. Itcl (dy
1750: 6e 61 6d 69 63 61 6c 6c 79 20 6c 69 6e 6b 65 64 namically linked
1760: 29 0a 0a 54 68 65 20 73 6f 75 72 63 65 20 63 6f )..The source co
1770: 64 65 20 66 6f 72 20 74 68 65 73 65 20 70 69 65 de for these pie
1780: 63 65 73 20 61 72 65 20 64 6f 77 6e 6c 6f 61 64 ces are download
1790: 65 64 2c 20 63 6f 6d 70 69 6c 65 64 2c 20 61 6e ed, compiled, an
17a0: 64 20 6c 69 6e 6b 65 64 2c 20 61 6e 64 20 74 68 d linked, and th
17b0: 65 0a 64 61 74 61 62 61 73 65 20 63 6f 6e 74 61 e.database conta
17c0: 69 6e 69 6e 67 20 74 68 65 20 61 70 70 72 6f 70 ining the approp
17d0: 72 69 61 74 65 20 66 69 6c 65 73 79 73 74 65 6d riate filesystem
17e0: 20 64 61 74 61 20 69 73 20 63 72 65 61 74 65 64 data is created
17f0: 2e 20 20 57 68 61 74 20 73 65 74 73 0a 74 68 69 . What sets.thi
1800: 73 20 70 72 6f 6a 65 63 74 20 61 70 61 72 74 20 s project apart
1810: 66 72 6f 6d 20 6f 74 68 65 72 20 73 69 6d 69 6c from other simil
1820: 61 72 20 70 72 6f 6a 65 63 74 73 20 69 73 20 74 ar projects is t
1830: 68 61 74 3a 0a 09 31 2e 20 49 74 20 61 74 74 65 hat:..1. It atte
1840: 6d 70 74 73 20 74 6f 20 62 65 20 6d 6f 64 75 6c mpts to be modul
1850: 61 72 3b 0a 09 32 2e 20 49 74 20 73 75 70 70 6f ar;..2. It suppo
1860: 72 74 73 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c rts cross-compil
1870: 69 6e 67 3b 0a 09 33 2e 20 49 74 20 64 6f 77 6e ing;..3. It down
1880: 6c 6f 61 64 73 20 74 68 65 20 73 6f 75 72 63 65 loads the source
1890: 20 66 72 6f 6d 20 74 68 65 69 72 20 6f 72 69 67 from their orig
18a0: 69 6e 61 6c 20 72 65 70 6f 73 69 74 6f 72 69 65 inal repositorie
18b0: 73 3b 0a 09 34 2e 20 49 74 20 61 6c 6c 6f 77 73 s;..4. It allows
18c0: 20 79 6f 75 20 74 6f 20 73 70 65 63 69 66 79 20 you to specify
18d0: 61 6e 20 61 72 62 69 74 72 61 72 79 20 76 65 72 an arbitrary ver
18e0: 73 69 6f 6e 20 6f 66 20 54 63 6c 20 28 69 6e 63 sion of Tcl (inc
18f0: 6c 75 64 69 6e 67 0a 09 20 20 20 43 56 53 29 3b luding.. CVS);
1900: 20 61 6e 64 0a 09 35 2e 20 49 74 20 75 73 65 73 and..5. It uses
1910: 20 47 4e 55 20 41 75 74 6f 63 6f 6e 66 20 73 63 GNU Autoconf sc
1920: 72 69 70 74 73 20 66 6f 72 20 63 6f 6d 70 69 6c ripts for compil
1930: 69 6e 67 20 74 68 65 20 70 61 72 74 20 6f 66 20 ing the part of
1940: 74 68 65 20 54 63 6c 6b 69 74 0a 09 20 20 20 74 the Tclkit.. t
1950: 68 61 74 20 62 72 69 6e 67 73 20 74 68 65 20 77 hat brings the w
1960: 68 6f 6c 65 20 74 68 69 6e 67 20 74 6f 67 65 74 hole thing toget
1970: 68 65 72 20 28 74 68 65 20 4b 69 74 73 68 29 0a her (the Kitsh).
1980: 0a 54 6f 20 61 63 63 6f 6d 70 6c 69 73 68 20 74 .To accomplish t
1990: 68 65 73 65 20 67 6f 61 6c 73 20 74 68 65 20 66 hese goals the f
19a0: 6f 6c 6c 6f 77 69 6e 67 20 6d 65 63 68 61 6e 69 ollowing mechani
19b0: 73 6d 73 20 61 72 65 20 69 6e 20 70 6c 61 63 65 sms are in place
19c0: 3a 0a 09 31 2e 20 54 68 65 20 74 6f 70 2d 6c 65 :..1. The top-le
19d0: 76 65 6c 20 22 6b 69 74 63 72 65 61 74 6f 72 22 vel "kitcreator"
19e0: 20 73 63 72 69 70 74 3b 20 61 6e 64 0a 09 32 2e script; and..2.
19f0: 20 50 65 72 2d 70 72 6f 6a 65 63 74 20 73 75 62 Per-project sub
1a00: 64 69 72 65 63 74 6f 72 69 65 73 2c 20 65 61 63 directories, eac
1a10: 68 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 22 h containing a "
1a20: 62 75 69 6c 64 2e 73 68 22 20 73 63 72 69 70 74 build.sh" script
1a30: 0a 0a 54 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 ..The top-level
1a40: 22 6b 69 74 63 72 65 61 74 6f 72 22 20 73 63 72 "kitcreator" scr
1a50: 69 70 74 20 69 73 20 76 65 72 79 20 73 69 6d 70 ipt is very simp
1a60: 6c 65 2e 20 20 49 74 73 20 6f 6e 6c 79 20 6a 6f le. Its only jo
1a70: 62 20 69 73 20 74 6f 0a 69 6e 74 65 72 70 72 65 b is to.interpre
1a80: 74 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 61 t command line a
1a90: 72 67 75 6d 65 6e 74 73 2c 20 61 6e 64 20 63 61 rguments, and ca
1aa0: 6c 6c 20 74 68 65 20 70 65 72 2d 70 72 6f 6a 65 ll the per-proje
1ab0: 63 74 20 22 62 75 69 6c 64 2e 73 68 22 20 73 63 ct "build.sh" sc
1ac0: 72 69 70 74 73 2e 0a 46 6f 72 20 74 68 65 20 22 ripts..For the "
1ad0: 74 63 6c 22 20 70 72 6f 6a 65 63 74 20 69 74 20 tcl" project it
1ae0: 61 6c 73 6f 20 66 69 6e 64 73 20 74 68 65 20 61 also finds the a
1af0: 70 70 72 6f 70 72 69 61 74 65 20 22 74 63 6c 43 ppropriate "tclC
1b00: 6f 6e 66 69 67 2e 73 68 22 20 28 61 6e 64 20 73 onfig.sh" (and s
1b10: 74 6f 72 65 73 0a 74 68 69 73 20 70 61 74 68 20 tores.this path
1b20: 69 6e 20 54 43 4c 43 4f 4e 46 49 47 44 49 52 29 in TCLCONFIGDIR)
1b30: 20 74 6f 20 65 6e 61 62 6c 65 20 73 75 62 73 65 to enable subse
1b40: 71 75 65 6e 74 20 62 75 69 6c 64 20 73 63 72 69 quent build scri
1b50: 70 74 73 20 74 6f 20 66 69 6e 64 20 74 68 65 0a pts to find the.
1b60: 61 70 70 72 6f 70 72 69 61 74 65 20 54 63 6c 20 appropriate Tcl
1b70: 74 6f 20 6c 69 6e 6b 20 61 67 61 69 6e 73 74 2e to link against.
1b80: 0a 0a 54 68 65 20 70 65 72 2d 70 72 6f 6a 65 63 ..The per-projec
1b90: 74 20 22 62 75 69 6c 64 2e 73 68 22 20 73 63 72 t "build.sh" scr
1ba0: 69 70 74 73 20 61 72 65 20 65 6e 74 69 72 65 6c ipts are entirel
1bb0: 79 20 61 75 74 6f 6e 6f 6d 6f 75 73 2e 20 20 54 y autonomous. T
1bc0: 68 65 79 20 61 72 65 0a 72 65 73 70 6f 6e 73 69 hey are.responsi
1bd0: 62 6c 65 20 66 6f 72 20 64 6f 77 6e 6c 6f 61 64 ble for download
1be0: 69 6e 67 20 74 68 65 20 73 6f 75 72 63 65 20 63 ing the source c
1bf0: 6f 64 65 20 66 6f 72 20 74 68 65 20 61 70 70 72 ode for the appr
1c00: 6f 70 72 69 61 74 65 20 76 65 72 73 69 6f 6e 20 opriate version
1c10: 74 68 61 74 0a 77 69 6c 6c 20 63 6f 6d 70 69 6c that.will compil
1c20: 65 20 61 6e 64 20 6c 69 6e 6b 20 61 67 61 69 6e e and link again
1c30: 73 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 st the current v
1c40: 65 72 73 69 6f 6e 20 6f 66 20 54 63 6c 20 28 75 ersion of Tcl (u
1c50: 73 65 72 20 72 65 71 75 65 73 74 65 64 0a 76 65 ser requested.ve
1c60: 72 73 69 6f 6e 20 63 61 6e 20 62 65 20 66 6f 75 rsion can be fou
1c70: 6e 64 20 69 6e 20 22 54 43 4c 56 45 52 53 22 2c nd in "TCLVERS",
1c80: 20 77 68 69 6c 65 20 74 68 65 20 61 63 74 75 61 while the actua
1c90: 6c 20 76 65 72 73 69 6f 6e 20 6d 75 73 74 20 62 l version must b
1ca0: 65 20 72 65 71 75 65 73 74 65 64 0a 66 72 6f 6d e requested.from
1cb0: 20 74 68 65 20 22 74 63 6c 43 6f 6e 66 69 67 2e the "tclConfig.
1cc0: 73 68 22 20 73 63 72 69 70 74 29 2c 20 63 6f 6d sh" script), com
1cd0: 70 69 6c 69 6e 67 20 69 74 2c 20 69 6e 73 74 61 piling it, insta
1ce0: 6c 6c 69 6e 67 20 61 20 66 75 6e 63 74 69 6f 6e lling a function
1cf0: 61 6c 20 63 6f 70 79 0a 69 6e 74 6f 20 74 68 65 al copy.into the
1d00: 20 70 65 72 2d 70 72 6f 6a 65 63 74 20 22 69 6e per-project "in
1d10: 73 74 22 20 64 69 72 65 63 74 6f 72 79 2c 20 61 st" directory, a
1d20: 6e 64 20 69 6e 73 74 61 6c 6c 69 6e 67 20 61 6e nd installing an
1d30: 79 74 68 69 6e 67 20 74 68 61 74 20 6e 65 65 64 ything that need
1d40: 73 20 74 6f 0a 62 65 20 69 6e 20 74 68 65 20 54 s to.be in the T
1d50: 63 6c 6b 69 74 27 73 20 56 46 53 20 72 6f 6f 74 clkit's VFS root
1d60: 20 69 6e 74 6f 20 74 68 65 20 70 65 72 2d 70 72 into the per-pr
1d70: 6f 6a 65 63 74 20 22 6f 75 74 22 20 64 69 72 65 oject "out" dire
1d80: 63 74 6f 72 79 2e 0a 0a 54 68 65 20 65 78 63 65 ctory...The exce
1d90: 70 74 69 6f 6e 20 74 6f 20 74 68 69 73 20 69 73 ption to this is
1da0: 20 74 68 65 20 22 6b 69 74 73 68 22 20 61 6e 64 the "kitsh" and
1db0: 20 22 6b 69 74 64 6c 6c 22 20 70 72 6f 6a 65 63 "kitdll" projec
1dc0: 74 73 2e 20 20 54 68 65 79 20 61 72 65 20 74 68 ts. They are th
1dd0: 65 20 67 6c 75 65 0a 74 68 61 74 20 62 69 6e 64 e glue.that bind
1de0: 73 20 61 6c 6c 20 74 68 65 20 69 6e 64 69 76 69 s all the indivi
1df0: 64 75 61 6c 20 70 72 6f 6a 65 63 74 73 20 74 6f dual projects to
1e00: 67 65 74 68 65 72 20 69 6e 74 6f 20 61 20 73 69 gether into a si
1e10: 6e 67 6c 65 20 65 78 65 63 75 74 61 62 6c 65 2e ngle executable.
1e20: 20 20 49 74 73 0a 62 75 69 6c 64 20 73 63 72 69 Its.build scri
1e30: 70 74 20 64 6f 65 73 20 6e 6f 74 20 63 72 65 61 pt does not crea
1e40: 74 65 20 61 6e 20 22 69 6e 73 74 22 20 6f 72 20 te an "inst" or
1e50: 61 6e 20 22 6f 75 74 22 20 64 69 72 65 63 74 6f an "out" directo
1e60: 72 79 20 62 65 63 61 75 73 65 20 69 74 20 69 73 ry because it is
1e70: 20 6e 6f 74 0a 61 20 6c 69 62 72 61 72 79 2e 20 not.a library.
1e80: 20 49 6e 73 74 65 61 64 2c 20 69 74 20 63 6f 6c Instead, it col
1e90: 6c 65 63 74 73 20 61 6c 6c 20 74 68 65 20 6f 74 lects all the ot
1ea0: 68 65 72 20 70 72 6f 6a 65 63 74 27 73 20 22 6f her project's "o
1eb0: 75 74 22 20 64 69 72 65 63 74 6f 72 69 65 73 0a ut" directories.
1ec0: 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20 64 69 into a single di
1ed0: 72 65 63 74 6f 72 79 20 28 73 74 61 72 70 61 63 rectory (starpac
1ee0: 6b 2e 76 66 73 29 2c 20 61 73 20 77 65 6c 6c 20 k.vfs), as well
1ef0: 61 20 73 74 61 74 69 63 20 66 69 6c 65 20 28 62 a static file (b
1f00: 6f 6f 74 2e 74 63 6c 29 2e 0a 49 74 20 74 68 65 oot.tcl)..It the
1f10: 6e 20 63 6f 6d 70 69 6c 65 73 20 74 68 65 20 73 n compiles the s
1f20: 6f 75 72 63 65 20 63 6f 64 65 2c 20 61 6e 64 20 ource code, and
1f30: 74 68 65 6e 20 69 6e 73 74 61 6c 6c 73 20 74 68 then installs th
1f40: 65 20 56 46 53 20 6f 6e 74 6f 20 74 68 65 20 72 e VFS onto the r
1f50: 65 73 75 6c 74 69 6e 67 0a 65 78 65 63 75 74 61 esulting.executa
1f60: 62 6c 65 2e 20 20 54 68 65 20 56 46 53 20 69 73 ble. The VFS is
1f70: 20 63 72 65 61 74 65 64 20 62 79 20 74 68 65 20 created by the
1f80: 22 69 6e 73 74 61 6c 6c 76 66 73 2e 74 63 6c 22 "installvfs.tcl"
1f90: 20 73 63 72 69 70 74 20 66 6f 72 20 4b 69 74 73 script for Kits
1fa0: 68 2e 20 20 46 6f 72 0a 4b 69 74 44 4c 4c 20 74 h. For.KitDLL t
1fb0: 68 65 20 56 46 53 20 69 73 20 63 72 65 61 74 65 he VFS is create
1fc0: 64 20 62 79 20 22 64 69 72 32 63 2e 74 63 6c 22 d by "dir2c.tcl"
1fd0: 2e 0a 0a 49 66 20 74 68 65 20 22 6d 6b 34 74 63 ...If the "mk4tc
1fe0: 6c 22 20 70 72 6f 6a 65 63 74 20 66 61 69 6c 73 l" project fails
1ff0: 20 74 6f 20 62 75 69 6c 64 20 28 6f 72 20 69 73 to build (or is
2000: 20 6e 6f 74 20 72 65 71 75 65 73 74 65 64 20 74 not requested t
2010: 6f 20 62 65 20 62 75 69 6c 74 29 2c 0a 74 68 65 o be built),.the
2020: 20 72 65 73 74 20 6f 66 20 74 68 65 20 70 72 6f rest of the pro
2030: 6a 65 63 74 20 77 69 6c 6c 20 62 65 20 62 75 69 ject will be bui
2040: 6c 74 20 75 73 69 6e 67 20 7a 69 70 20 66 69 6c lt using zip fil
2050: 65 73 20 69 6e 73 74 65 61 64 20 6f 66 20 4d 65 es instead of Me
2060: 74 61 6b 69 74 0a 64 61 74 61 62 61 73 65 73 2e takit.databases.
2070: 0a 0a 54 6f 20 63 72 65 61 74 65 20 74 68 65 20 ..To create the
2080: 73 74 6f 72 61 67 65 20 64 61 74 61 62 61 73 65 storage database
2090: 2c 20 6f 6e 65 20 6f 66 20 74 77 6f 20 54 63 6c , one of two Tcl
20a0: 6b 69 74 73 20 69 73 20 75 73 65 64 20 28 74 72 kits is used (tr
20b0: 69 65 64 20 69 6e 20 74 68 69 73 0a 6f 72 64 65 ied in this.orde
20c0: 72 29 3a 0a 09 31 2e 20 54 68 65 20 54 63 6c 6b r):..1. The Tclk
20d0: 69 74 20 73 70 65 63 69 66 69 65 64 20 62 79 20 it specified by
20e0: 74 68 65 20 54 43 4c 4b 49 54 20 65 6e 76 69 72 the TCLKIT envir
20f0: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 onment variable
2100: 28 6f 72 0a 09 20 20 20 22 74 63 6c 6b 69 74 22 (or.. "tclkit"
2110: 20 69 66 20 74 68 61 74 20 76 61 72 69 61 62 6c if that variabl
2120: 65 20 69 73 20 6e 6f 74 20 73 65 74 29 20 69 66 e is not set) if
2130: 20 69 74 20 69 73 20 66 75 6e 63 74 69 6f 6e 61 it is functiona
2140: 6c 3b 20 6f 72 0a 09 32 2e 20 54 68 65 20 62 75 l; or..2. The bu
2150: 69 6c 74 20 54 63 6c 6b 69 74 20 69 74 73 65 6c ilt Tclkit itsel
2160: 66 0a 0a 54 68 65 20 73 65 63 6f 6e 64 20 6d 65 f..The second me
2170: 74 68 6f 64 20 77 69 6c 6c 20 6e 6f 74 20 77 6f thod will not wo
2180: 72 6b 20 69 66 20 74 68 65 20 62 75 69 6c 74 20 rk if the built
2190: 54 63 6c 6b 69 74 20 69 73 20 6e 6f 74 20 65 78 Tclkit is not ex
21a0: 65 63 75 74 61 62 6c 65 20 6f 6e 20 74 68 65 0a ecutable on the.
21b0: 63 75 72 72 65 6e 74 20 70 6c 61 74 66 6f 72 6d current platform
21c0: 20 28 69 2e 65 2e 2c 20 69 6e 20 74 68 65 20 63 (i.e., in the c
21d0: 61 73 65 20 6f 66 20 63 72 6f 73 73 2d 63 6f 6d ase of cross-com
21e0: 70 69 6c 61 74 69 6f 6e 29 20 61 6e 64 20 73 6f pilation) and so
21f0: 20 69 74 20 6d 61 79 20 62 65 0a 6e 65 63 65 73 it may be.neces
2200: 73 61 72 79 20 74 6f 20 62 6f 6f 74 73 74 72 61 sary to bootstra
2210: 70 20 61 20 72 75 6e 6e 61 62 6c 65 20 54 63 6c p a runnable Tcl
2220: 6b 69 74 20 66 69 72 73 74 2e 0a 0a 4b 69 74 44 kit first...KitD
2230: 4c 4c 20 6d 6f 75 6e 74 73 20 74 68 65 20 56 46 LL mounts the VF
2240: 53 20 66 6f 72 20 65 76 65 72 79 20 69 6e 74 65 S for every inte
2250: 72 70 72 65 74 65 72 20 74 68 61 74 20 63 61 6c rpreter that cal
2260: 6c 73 20 54 63 6c 5f 49 6e 69 74 28 29 2e 20 20 ls Tcl_Init().
2270: 54 68 65 20 73 79 73 74 65 6d 0a 56 46 53 20 74 The system.VFS t
2280: 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20 61 hat is created a
2290: 74 20 62 75 69 6c 64 20 74 69 6d 65 20 69 73 20 t build time is
22a0: 6d 6f 75 6e 74 65 64 20 61 74 20 2f 2e 4b 49 54 mounted at /.KIT
22b0: 44 4c 4c 5f 54 43 4c 2e 20 20 41 64 64 69 74 69 DLL_TCL. Additi
22c0: 6f 6e 61 6c 6c 79 2c 0a 69 66 20 74 68 65 72 65 onally,.if there
22d0: 20 69 73 20 61 20 5a 49 50 20 66 69 6c 65 20 61 is a ZIP file a
22e0: 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 44 ppended to the D
22f0: 4c 4c 20 69 74 20 77 69 6c 6c 20 62 65 20 6d 6f LL it will be mo
2300: 75 6e 74 65 64 20 61 74 20 2f 2e 4b 49 54 44 4c unted at /.KITDL
2310: 4c 5f 55 53 45 52 0a 61 6e 64 20 69 66 20 74 68 L_USER.and if th
2320: 65 72 65 20 69 73 20 61 20 5a 49 50 20 66 69 6c ere is a ZIP fil
2330: 65 20 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 e appended to th
2340: 65 20 65 78 65 63 75 74 61 62 6c 65 20 69 74 20 e executable it
2350: 77 69 6c 6c 20 62 65 20 6d 6f 75 6e 74 65 64 20 will be mounted
2360: 61 74 0a 2f 2e 4b 49 54 44 4c 4c 5f 41 50 50 2e at./.KITDLL_APP.
2370: 20 20 41 6c 6c 20 56 46 53 65 73 20 74 68 61 74 All VFSes that
2380: 20 61 72 65 20 6d 6f 75 6e 74 65 64 20 68 61 76 are mounted hav
2390: 65 20 74 68 65 20 22 6c 69 62 22 20 73 75 62 2d e the "lib" sub-
23a0: 64 69 72 65 63 74 6f 72 79 20 61 70 70 65 6e 64 directory append
23b0: 65 64 0a 74 6f 20 74 68 65 20 69 6e 74 65 72 70 ed.to the interp
23c0: 72 65 74 65 72 73 20 22 61 75 74 6f 5f 70 61 74 reters "auto_pat
23d0: 68 22 20 76 61 72 69 61 62 6c 65 2e 0a h" variable..