Hex Artifact Content

Artifact ed4af58f562d43ae17cdc23eca13cdf1bf271e4d:


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 20 66 6f 72 20 54 63 6c 20 38 2e  clkit for Tcl 8.
01f0: 35 2e 38 3a 0a 09 09 61 2e 20 24 20 2e 2f 6b 69  5.8:...a. $ ./ki
0200: 74 63 72 65 61 74 6f 72 20 38 2e 35 2e 38 0a 0a  tcreator 8.5.8..
0210: 09 32 2e 20 43 72 65 61 74 65 20 61 20 54 63 6c  .2. Create a Tcl
0220: 6b 69 74 20 66 6f 72 20 54 63 6c 20 66 72 6f 6d  kit for Tcl from
0230: 20 43 56 53 20 48 45 41 44 3a 0a 09 09 61 2e 20   CVS HEAD:...a. 
0240: 24 20 2e 2f 6b 69 74 63 72 65 61 74 6f 72 20 63  $ ./kitcreator c
0250: 76 73 5f 48 45 41 44 0a 0a 09 33 2e 20 43 6f 6d  vs_HEAD...3. Com
0260: 70 69 6c 65 20 61 20 36 34 2d 62 69 74 20 54 63  pile a 64-bit Tc
0270: 6c 6b 69 74 3a 0a 09 09 61 2e 20 24 20 2e 2f 6b  lkit:...a. $ ./k
0280: 69 74 63 72 65 61 74 6f 72 20 2d 2d 65 6e 61 62  itcreator --enab
0290: 6c 65 2d 36 34 62 69 74 0a 0a 09 34 2e 20 43 72  le-64bit...4. Cr
02a0: 6f 73 73 2d 63 6f 6d 70 69 6c 65 20 61 20 54 63  oss-compile a Tc
02b0: 6c 6b 69 74 3a 0a 09 09 61 2e 20 42 6f 6f 74 73  lkit:...a. Boots
02c0: 74 72 61 70 20 28 6f 70 74 69 6f 6e 61 6c 2c 20  trap (optional, 
02d0: 79 6f 75 20 63 61 6e 20 75 73 65 20 61 6e 20 65  you can use an e
02e0: 78 69 73 74 69 6e 67 20 54 63 6c 6b 69 74 29 3a  xisting Tclkit):
02f0: 0a 09 09 09 69 2e 20 20 20 24 20 2e 2f 6b 69 74  ....i.   $ ./kit
0300: 63 72 65 61 74 6f 72 0a 09 09 09 69 69 2e 20 20  creator....ii.  
0310: 24 20 6d 76 20 74 63 6c 6b 69 74 2d 38 2e 34 2e  $ mv tclkit-8.4.
0320: 31 39 20 74 63 6c 6b 69 74 2d 6c 6f 63 61 6c 0a  19 tclkit-local.
0330: 09 09 09 69 69 69 2e 20 24 20 54 43 4c 4b 49 54  ...iii. $ TCLKIT
0340: 3d 22 60 70 77 64 60 2f 74 63 6c 6b 69 74 2d 6c  ="`pwd`/tclkit-l
0350: 6f 63 61 6c 22 0a 09 09 09 69 76 2e 20 20 24 20  ocal"....iv.  $ 
0360: 65 78 70 6f 72 74 20 54 43 4c 4b 49 54 0a 09 09  export TCLKIT...
0370: 62 2e 20 43 72 6f 73 73 2d 63 6f 6d 70 69 6c 65  b. Cross-compile
0380: 3a 0a 09 09 09 69 2e 20 20 20 24 20 43 43 3d 6d  :....i.   $ CC=m
0390: 69 70 73 65 6c 2d 6c 69 6e 75 78 2d 75 63 6c 69  ipsel-linux-ucli
03a0: 62 63 2d 67 63 63 0a 09 09 09 69 69 2e 20 20 24  bc-gcc....ii.  $
03b0: 20 41 52 3d 6d 69 70 73 65 6c 2d 6c 69 6e 75 78   AR=mipsel-linux
03c0: 2d 75 63 6c 69 62 63 2d 61 72 0a 09 09 09 69 69  -uclibc-ar....ii
03d0: 69 2e 20 24 20 52 41 4e 4c 49 42 3d 6d 69 70 73  i. $ RANLIB=mips
03e0: 65 6c 2d 6c 69 6e 75 78 2d 75 63 6c 69 62 63 2d  el-linux-uclibc-
03f0: 72 61 6e 6c 69 62 0a 09 09 09 69 76 2e 20 20 24  ranlib....iv.  $
0400: 20 65 78 70 6f 72 74 20 43 43 20 41 52 20 52 41   export CC AR RA
0410: 4e 4c 49 42 0a 09 09 76 2e 20 20 20 24 20 2e 2f  NLIB...v.   $ ./
0420: 6b 69 74 63 72 65 61 74 6f 72 20 2d 2d 68 6f 73  kitcreator --hos
0430: 74 3d 6d 69 70 73 65 6c 2d 6c 69 6e 75 78 2d 75  t=mipsel-linux-u
0440: 63 6c 69 62 63 0a 0a 09 35 2e 20 43 6f 6d 70 69  clibc...5. Compi
0450: 6c 65 20 61 20 36 34 2d 62 69 74 20 54 63 6c 6b  le a 64-bit Tclk
0460: 69 74 20 38 2e 35 2e 38 20 75 73 69 6e 67 20 53  it 8.5.8 using S
0470: 75 6e 53 74 75 64 69 6f 20 31 32 2e 31 20 6f 6e  unStudio 12.1 on
0480: 20 53 6f 6c 61 72 69 73 2f 78 38 36 3a 0a 09 09   Solaris/x86:...
0490: 61 2e 20 24 20 43 43 3d 27 2f 6f 70 74 2f 73 75  a. $ CC='/opt/su
04a0: 6e 73 74 75 64 69 6f 31 32 2e 31 2f 62 69 6e 2f  nstudio12.1/bin/
04b0: 63 63 20 2d 6d 36 34 27 0a 09 09 62 2e 20 24 20  cc -m64'...b. $ 
04c0: 43 58 58 3d 27 2f 6f 70 74 2f 73 75 6e 73 74 75  CXX='/opt/sunstu
04d0: 64 69 6f 31 32 2e 31 2f 62 69 6e 2f 43 43 20 2d  dio12.1/bin/CC -
04e0: 6d 36 34 27 0a 09 09 63 2e 20 24 20 65 78 70 6f  m64'...c. $ expo
04f0: 72 74 20 43 43 20 43 58 58 0a 09 09 64 2e 20 24  rt CC CXX...d. $
0500: 20 2e 2f 6b 69 74 63 72 65 61 74 6f 72 20 38 2e   ./kitcreator 8.
0510: 35 2e 38 20 2d 2d 65 6e 61 62 6c 65 2d 36 34 62  5.8 --enable-64b
0520: 69 74 0a 0a 09 36 2e 20 54 6f 20 63 6c 65 61 6e  it...6. To clean
0530: 20 75 70 20 70 6f 73 74 2d 62 75 69 6c 64 3a 0a   up post-build:.
0540: 09 09 61 2e 20 24 20 2e 2f 6b 69 74 63 72 65 61  ..a. $ ./kitcrea
0550: 74 6f 72 20 63 6c 65 61 6e 0a 0a 45 6e 76 69 72  tor clean..Envir
0560: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73  onment variables
0570: 3a 0a 09 31 2e 20 4d 41 4b 45 0a 09 09 53 70 65  :..1. MAKE...Spe
0580: 63 69 66 69 65 73 20 74 68 65 20 74 6f 6f 6c 20  cifies the tool 
0590: 79 6f 75 20 77 69 73 68 20 74 6f 20 62 65 20 63  you wish to be c
05a0: 61 6c 6c 65 64 20 74 6f 20 62 75 69 6c 64 20 74  alled to build t
05b0: 61 72 67 65 74 73 0a 09 09 66 72 6f 6d 20 61 20  argets...from a 
05c0: 4d 61 6b 65 66 69 6c 65 2e 20 20 54 68 69 73 20  Makefile.  This 
05d0: 73 63 72 69 70 74 20 69 73 20 67 65 6e 65 72 61  script is genera
05e0: 6c 6c 79 20 6d 6f 72 65 20 77 65 6c 6c 20 74 65  lly more well te
05f0: 73 74 65 64 0a 09 09 77 69 74 68 20 47 4e 55 20  sted...with GNU 
0600: 4d 61 6b 65 2e 0a 0a 09 32 2e 20 50 41 54 43 48  Make....2. PATCH
0610: 0a 09 09 53 70 65 63 69 66 69 65 73 20 74 68 65  ...Specifies the
0620: 20 74 6f 6f 6c 20 79 6f 75 20 77 69 73 68 20 74   tool you wish t
0630: 6f 20 62 65 20 63 61 6c 6c 65 64 20 74 6f 20 61  o be called to a
0640: 70 70 6c 79 20 75 6e 69 66 69 65 64 0a 09 09 64  pply unified...d
0650: 69 66 66 20 70 61 74 63 68 65 73 2e 20 20 54 68  iff patches.  Th
0660: 69 73 20 73 63 72 69 70 74 20 69 73 20 67 65 6e  is script is gen
0670: 65 72 61 6c 6c 79 20 6d 6f 72 65 20 77 65 6c 6c  erally more well
0680: 20 74 65 73 74 65 64 20 77 69 74 68 0a 09 09 47   tested with...G
0690: 4e 55 20 50 61 74 63 68 2e 20 0a 0a 09 33 2e 20  NU Patch. ...3. 
06a0: 54 43 4c 4b 49 54 0a 09 09 53 70 65 63 69 66 79  TCLKIT...Specify
06b0: 20 74 68 65 20 70 61 74 68 20 74 6f 20 61 20 54   the path to a T
06c0: 63 6c 6b 69 74 20 74 68 61 74 20 69 73 20 72 75  clkit that is ru
06d0: 6e 6e 61 62 6c 65 20 6f 6e 20 74 68 65 20 63 75  nnable on the cu
06e0: 72 72 65 6e 74 0a 09 09 73 79 73 74 65 6d 2e 20  rrent...system. 
06f0: 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20   The default is 
0700: 22 74 63 6c 6b 69 74 22 2e 20 20 41 20 77 6f 72  "tclkit".  A wor
0710: 6b 69 6e 67 20 74 63 6c 6b 69 74 20 69 73 20 72  king tclkit is r
0720: 65 71 75 69 72 65 64 0a 09 09 66 6f 72 20 63 72  equired...for cr
0730: 6f 73 73 2d 63 6f 6d 70 69 6c 69 6e 67 20 54 63  oss-compiling Tc
0740: 6c 6b 69 74 73 2e 0a                             lkits..