Hex Artifact Content

Artifact 7af6d9d17c41f4877ea52bff7c5a19440fb127a8:


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 55 73 61 67 65 3a 0a 09 6b 69 74 63  "...Usage:..kitc
0040: 72 65 61 74 6f 72 20 5b 7b 3c 76 65 72 73 69 6f  reator [{<versio
0050: 6e 3e 20 7c 20 63 76 73 5f 3c 63 76 73 54 61 67  n> | cvs_<cvsTag
0060: 3e 20 7c 20 63 6c 65 61 6e 20 7c 20 64 69 73 74  > | clean | dist
0070: 63 6c 65 61 6e 7d 5d 0a 09 20 20 20 20 20 20 20  clean}]..       
0080: 20 20 20 20 5b 3c 63 6f 6e 66 69 67 75 72 65 5f      [<configure_
0090: 6f 70 74 69 6f 6e 73 2e 2e 2e 3e 5d 0a 0a 09 57  options...>]...W
00a0: 68 65 72 65 3a 0a 09 09 76 65 72 73 69 6f 6e 20  here:...version 
00b0: 20 20 20 20 20 20 20 20 20 20 20 69 73 20 61 20             is a 
00c0: 54 63 6c 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62  Tcl version numb
00d0: 65 72 20 28 65 2e 67 2e 2c 20 38 2e 34 2e 31 39  er (e.g., 8.4.19
00e0: 29 0a 09 09 63 76 73 54 61 67 20 20 20 20 20 20  )...cvsTag      
00f0: 20 20 20 20 20 20 20 69 73 20 61 20 43 56 53 20         is a CVS 
0100: 72 65 6c 65 61 73 65 20 74 61 67 20 28 65 2e 67  release tag (e.g
0110: 2e 2c 20 48 45 41 44 29 0a 09 09 63 6f 6e 66 69  ., HEAD)...confi
0120: 67 75 72 65 5f 6f 70 74 69 6f 6e 73 20 20 61 72  gure_options  ar
0130: 65 20 6f 70 74 69 6f 6e 73 20 74 6f 20 70 61 73  e options to pas
0140: 73 20 74 6f 20 73 75 62 6f 72 64 69 6e 61 74 65  s to subordinate
0150: 20 63 6f 6e 66 69 67 75 72 65 0a 09 09 20 20 20   configure...   
0160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0170: 73 63 72 69 70 74 73 20 28 65 2e 67 2e 2c 20 2d  scripts (e.g., -
0180: 2d 65 6e 61 62 6c 65 2d 36 34 62 69 74 29 0a 0a  -enable-64bit)..
0190: 09 44 65 66 61 75 6c 74 20 69 73 20 74 6f 20 63  .Default is to c
01a0: 72 65 61 74 65 20 61 20 54 63 6c 6b 69 74 20 66  reate a Tclkit f
01b0: 72 6f 6d 20 54 63 6c 20 76 65 72 73 69 6f 6e 20  rom Tcl version 
01c0: 38 2e 34 2e 31 39 0a 0a 45 78 61 6d 70 6c 65 73  8.4.19..Examples
01d0: 3a 0a 09 31 2e 20 43 72 65 61 74 65 20 61 20 54  :..1. Create a T
01e0: 63 6c 6b 69 74 3a 0a 09 09 61 2e 20 24 20 2e 2f  clkit:...a. $ ./
01f0: 6b 69 74 63 72 65 61 74 6f 72 0a 0a 09 32 2e 20  kitcreator...2. 
0200: 43 72 65 61 74 65 20 61 20 54 63 6c 6b 69 74 20  Create a Tclkit 
0210: 66 6f 72 20 54 63 6c 20 38 2e 35 2e 38 3a 0a 09  for Tcl 8.5.8:..
0220: 09 61 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61 74  .a. $ ./kitcreat
0230: 6f 72 20 38 2e 35 2e 38 0a 0a 09 33 2e 20 43 72  or 8.5.8...3. Cr
0240: 65 61 74 65 20 61 20 54 63 6c 6b 69 74 20 66 6f  eate a Tclkit fo
0250: 72 20 54 63 6c 20 66 72 6f 6d 20 43 56 53 20 48  r Tcl from CVS H
0260: 45 41 44 3a 0a 09 09 61 2e 20 24 20 2e 2f 6b 69  EAD:...a. $ ./ki
0270: 74 63 72 65 61 74 6f 72 20 63 76 73 5f 48 45 41  tcreator cvs_HEA
0280: 44 0a 0a 09 34 2e 20 43 6f 6d 70 69 6c 65 20 61  D...4. Compile a
0290: 20 36 34 2d 62 69 74 20 54 63 6c 6b 69 74 3a 0a   64-bit Tclkit:.
02a0: 09 09 61 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61  ..a. $ ./kitcrea
02b0: 74 6f 72 20 2d 2d 65 6e 61 62 6c 65 2d 36 34 62  tor --enable-64b
02c0: 69 74 0a 0a 09 35 2e 20 43 72 6f 73 73 2d 63 6f  it...5. Cross-co
02d0: 6d 70 69 6c 65 20 61 20 54 63 6c 6b 69 74 3a 0a  mpile a Tclkit:.
02e0: 09 09 61 2e 20 42 6f 6f 74 73 74 72 61 70 20 28  ..a. Bootstrap (
02f0: 6f 70 74 69 6f 6e 61 6c 2c 20 79 6f 75 20 63 61  optional, you ca
0300: 6e 20 75 73 65 20 61 6e 20 65 78 69 73 74 69 6e  n use an existin
0310: 67 20 54 63 6c 6b 69 74 29 3a 0a 09 09 09 69 2e  g Tclkit):....i.
0320: 20 20 20 24 20 2e 2f 6b 69 74 63 72 65 61 74 6f     $ ./kitcreato
0330: 72 0a 09 09 09 69 69 2e 20 20 24 20 6d 76 20 74  r....ii.  $ mv t
0340: 63 6c 6b 69 74 2d 38 2e 34 2e 31 39 20 74 63 6c  clkit-8.4.19 tcl
0350: 6b 69 74 2d 6c 6f 63 61 6c 0a 09 09 09 69 69 69  kit-local....iii
0360: 2e 20 24 20 54 43 4c 4b 49 54 3d 22 60 70 77 64  . $ TCLKIT="`pwd
0370: 60 2f 74 63 6c 6b 69 74 2d 6c 6f 63 61 6c 22 0a  `/tclkit-local".
0380: 09 09 09 69 76 2e 20 20 24 20 65 78 70 6f 72 74  ...iv.  $ export
0390: 20 54 43 4c 4b 49 54 0a 09 09 62 2e 20 43 72 6f   TCLKIT...b. Cro
03a0: 73 73 2d 63 6f 6d 70 69 6c 65 3a 0a 09 09 09 69  ss-compile:....i
03b0: 2e 20 20 20 24 20 43 43 3d 6d 69 70 73 65 6c 2d  .   $ CC=mipsel-
03c0: 6c 69 6e 75 78 2d 75 63 6c 69 62 63 2d 67 63 63  linux-uclibc-gcc
03d0: 0a 09 09 09 69 69 2e 20 20 24 20 41 52 3d 6d 69  ....ii.  $ AR=mi
03e0: 70 73 65 6c 2d 6c 69 6e 75 78 2d 75 63 6c 69 62  psel-linux-uclib
03f0: 63 2d 61 72 0a 09 09 09 69 69 69 2e 20 24 20 52  c-ar....iii. $ R
0400: 41 4e 4c 49 42 3d 6d 69 70 73 65 6c 2d 6c 69 6e  ANLIB=mipsel-lin
0410: 75 78 2d 75 63 6c 69 62 63 2d 72 61 6e 6c 69 62  ux-uclibc-ranlib
0420: 0a 09 09 09 69 76 2e 20 20 24 20 65 78 70 6f 72  ....iv.  $ expor
0430: 74 20 43 43 20 41 52 20 52 41 4e 4c 49 42 0a 09  t CC AR RANLIB..
0440: 09 76 2e 20 20 20 24 20 2e 2f 6b 69 74 63 72 65  .v.   $ ./kitcre
0450: 61 74 6f 72 20 2d 2d 68 6f 73 74 3d 6d 69 70 73  ator --host=mips
0460: 65 6c 2d 6c 69 6e 75 78 2d 75 63 6c 69 62 63 0a  el-linux-uclibc.
0470: 0a 09 36 2e 20 43 6f 6d 70 69 6c 65 20 61 20 36  ..6. Compile a 6
0480: 34 2d 62 69 74 20 54 63 6c 6b 69 74 20 38 2e 35  4-bit Tclkit 8.5
0490: 2e 38 20 75 73 69 6e 67 20 53 75 6e 53 74 75 64  .8 using SunStud
04a0: 69 6f 20 31 32 2e 31 20 6f 6e 20 53 6f 6c 61 72  io 12.1 on Solar
04b0: 69 73 2f 78 38 36 3a 0a 09 09 61 2e 20 24 20 43  is/x86:...a. $ C
04c0: 43 3d 27 2f 6f 70 74 2f 73 75 6e 73 74 75 64 69  C='/opt/sunstudi
04d0: 6f 31 32 2e 31 2f 62 69 6e 2f 63 63 20 2d 6d 36  o12.1/bin/cc -m6
04e0: 34 27 0a 09 09 62 2e 20 24 20 43 58 58 3d 27 2f  4'...b. $ CXX='/
04f0: 6f 70 74 2f 73 75 6e 73 74 75 64 69 6f 31 32 2e  opt/sunstudio12.
0500: 31 2f 62 69 6e 2f 43 43 20 2d 6d 36 34 27 0a 09  1/bin/CC -m64'..
0510: 09 63 2e 20 24 20 50 41 54 43 48 3d 27 67 70 61  .c. $ PATCH='gpa
0520: 74 63 68 27 0a 09 09 63 2e 20 24 20 65 78 70 6f  tch'...c. $ expo
0530: 72 74 20 43 43 20 43 58 58 20 50 41 54 43 48 0a  rt CC CXX PATCH.
0540: 09 09 64 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61  ..d. $ ./kitcrea
0550: 74 6f 72 20 38 2e 35 2e 38 20 2d 2d 65 6e 61 62  tor 8.5.8 --enab
0560: 6c 65 2d 36 34 62 69 74 0a 0a 09 37 2e 20 54 6f  le-64bit...7. To
0570: 20 63 6c 65 61 6e 20 75 70 20 70 6f 73 74 2d 62   clean up post-b
0580: 75 69 6c 64 3a 0a 09 09 61 2e 20 24 20 2e 2f 6b  uild:...a. $ ./k
0590: 69 74 63 72 65 61 74 6f 72 20 63 6c 65 61 6e 0a  itcreator clean.
05a0: 0a 45 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72  .Environment var
05b0: 69 61 62 6c 65 73 3a 0a 09 31 2e 20 4d 41 4b 45  iables:..1. MAKE
05c0: 0a 09 09 53 70 65 63 69 66 69 65 73 20 74 68 65  ...Specifies the
05d0: 20 74 6f 6f 6c 20 79 6f 75 20 77 69 73 68 20 74   tool you wish t
05e0: 6f 20 62 65 20 63 61 6c 6c 65 64 20 74 6f 20 62  o be called to b
05f0: 75 69 6c 64 20 74 61 72 67 65 74 73 0a 09 09 66  uild targets...f
0600: 72 6f 6d 20 61 20 4d 61 6b 65 66 69 6c 65 2e 20  rom a Makefile. 
0610: 20 54 68 69 73 20 73 63 72 69 70 74 20 69 73 20   This script is 
0620: 67 65 6e 65 72 61 6c 6c 79 20 6d 6f 72 65 20 77  generally more w
0630: 65 6c 6c 20 74 65 73 74 65 64 0a 09 09 77 69 74  ell tested...wit
0640: 68 20 47 4e 55 20 4d 61 6b 65 2e 0a 0a 09 32 2e  h GNU Make....2.
0650: 20 50 41 54 43 48 0a 09 09 53 70 65 63 69 66 69   PATCH...Specifi
0660: 65 73 20 74 68 65 20 74 6f 6f 6c 20 79 6f 75 20  es the tool you 
0670: 77 69 73 68 20 74 6f 20 62 65 20 63 61 6c 6c 65  wish to be calle
0680: 64 20 74 6f 20 61 70 70 6c 79 20 75 6e 69 66 69  d to apply unifi
0690: 65 64 0a 09 09 64 69 66 66 20 70 61 74 63 68 65  ed...diff patche
06a0: 73 2e 20 20 54 68 69 73 20 73 63 72 69 70 74 20  s.  This script 
06b0: 69 73 20 67 65 6e 65 72 61 6c 6c 79 20 6d 6f 72  is generally mor
06c0: 65 20 77 65 6c 6c 20 74 65 73 74 65 64 20 77 69  e well tested wi
06d0: 74 68 0a 09 09 47 4e 55 20 50 61 74 63 68 2e 20  th...GNU Patch. 
06e0: 0a 0a 09 33 2e 20 54 43 4c 4b 49 54 0a 09 09 53  ...3. TCLKIT...S
06f0: 70 65 63 69 66 79 20 74 68 65 20 70 61 74 68 20  pecify the path 
0700: 74 6f 20 61 20 54 63 6c 6b 69 74 20 74 68 61 74  to a Tclkit that
0710: 20 69 73 20 72 75 6e 6e 61 62 6c 65 20 6f 6e 20   is runnable on 
0720: 74 68 65 20 63 75 72 72 65 6e 74 0a 09 09 73 79  the current...sy
0730: 73 74 65 6d 2e 20 20 54 68 65 20 64 65 66 61 75  stem.  The defau
0740: 6c 74 20 69 73 20 22 74 63 6c 6b 69 74 22 2e 20  lt is "tclkit". 
0750: 20 41 20 77 6f 72 6b 69 6e 67 20 74 63 6c 6b 69   A working tclki
0760: 74 20 69 73 20 72 65 71 75 69 72 65 64 0a 09 09  t is required...
0770: 66 6f 72 20 63 72 6f 73 73 2d 63 6f 6d 70 69 6c  for cross-compil
0780: 69 6e 67 20 54 63 6c 6b 69 74 73 2e 0a           ing Tclkits..