README
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:7k
源码类别:

通讯编程

开发平台:

Visual C++

  1. Tcl Mac OS X README
  2. -------------------
  3. RCS: @(#) $Id: README,v 1.1.2.9 2007/04/29 02:21:33 das Exp $
  4. This is the README file for the Mac OS X/Darwin version of Tcl.
  5. 1. Where to go for support
  6. --------------------------
  7. - The tcl-mac mailing list on sourceforge is the best place to ask questions
  8. specific to Tcl & Tk on Mac OS X:
  9. http://lists.sourceforge.net/lists/listinfo/tcl-mac
  10. (this page also has a link to searchable archives of the list, please check them
  11. before asking on the list, many questions have already been answered).
  12. - For general Tcl/Tk questions, the newsgroup comp.lang.tcl is your best bet:
  13. http://groups.google.com/group/comp.lang.tcl/
  14. - The Tcl'ers Wiki also has many pages dealing with Tcl & Tk on Mac OS X, see
  15. http://wiki.tcl.tk/references/3753!
  16. http://wiki.tcl.tk/references/8361!
  17. - Please report bugs with Tcl or Tk on Mac OS X to the sourceforge bug trackers:
  18. Tcl: http://sf.net/tracker/?func=add&group_id=10894&atid=110894
  19. Tk:  http://sf.net/tracker/?func=add&group_id=12997&atid=112997
  20. please make sure that your report Tk specific bugs to the tktoolkit project bug
  21. tracker rather than the tcl project bug tracker.
  22. Mac OS X specific bugs should usually be assigned to 'das' or 'wolfsuit'.
  23. 2. Using Tcl on Mac OS X
  24. ------------------------
  25. - At a minimum, Mac OS X 10.1 is required to run Tcl, but OS X 10.3 or higher is
  26. recommended (certain [file] operations behave incorrectly on earlier releases).
  27. - Unless weak-linking is used, Tcl built on Mac OS X 10.x will not run on 10.y
  28. with y < x; on the other hand Tcl built on 10.y will always run on 10.x with
  29. y <= x (but without any of the fixes and optimizations that would be available
  30. in a binary built on 10.x).
  31. Weak-linking is available on OS X 10.2 or later, it additionally allows Tcl
  32. built on 10.x to run on any 10.y with x > y >= z (for a chosen z >= 2).
  33. - Tcl extensions can be installed in any of:
  34. $HOME/Library/Tcl /Library/Tcl /Network/Library/Tcl /System/Library/Tcl
  35. $HOME/Library/Frameworks /Library/Frameworks /Network/Library/Frameworks
  36. /System/Library/Frameworks (searched in that order).
  37. Given a potential package directory $pkg, Tcl on OSX checks for the file
  38. $pkg/Resources/Scripts/pkgIndex.tcl as well as the usual $pkg/pkgIndex.tcl.
  39. This allows building extensions as frameworks with all script files contained in
  40. the Resources/Scripts directory of the framework.
  41. - [load]able binary extensions can linked as either ordinary shared libraries
  42. (.dylib) or as MachO bundles (since 8.4.10/8.5a3); only bundles can be unloaded,
  43. and bundles are also loaded more efficiently from VFS (no temporary copy to the
  44. native filesystem required).
  45. - The 'deploy' target of macosx/Makefile installs the html manpages into the
  46. standard documentation location in the Tcl framework:
  47. Tcl.framework/Resources/Documentation/Reference/Tcl
  48. No nroff manpages are installed by default by the Makefile.
  49. - The Tcl framework can be installed in any of the system's standard
  50. framework directories:
  51. $HOME/Library/Frameworks /Library/Frameworks
  52. /Network/Library/Frameworks /System/Library/Frameworks
  53. 3. Building Tcl on Mac OS X
  54. ---------------------------
  55. - At least Mac OS X 10.1 is required to build Tcl, and Apple's Developer Tools
  56. need to be installed (only the most recent version matching your OS release is
  57. supported). The Developer Tools installer is available on Mac OS X retail disks
  58. or is present in /Applications/Installers on Macs that came with OS X
  59. preinstalled. The most recent version can be downloaded from the ADC website
  60. http://connect.apple.com (after you register for free ADC membership).
  61. - Tcl is most easily built as a Mac OS X framework via Makefile in tcl/macosx
  62. (see below for details), but can also be built with the standard unix configure
  63. and make buildsystem in tcl/unix as on any other unix platform (indeed, the
  64. Makefile is just a wrapper around the unix buildsystem).
  65. The Mac OS X specific configure flags are --enable-framework and
  66. --disable-corefoundation (which disables CF and notably reverts to the standard
  67. select based notifier).
  68. - It is also possible to build with Apple's IDE via the tcl/macosx/Tcl.pbproj
  69. project, this simply calls through to the tcl/macosx/Makefile.
  70. - To build universal binaries, set CFLAGS as follows:
  71.     export CFLAGS="-arch ppc -arch ppc64 -arch i386 -arch x86_64 
  72. -isysroot /Developer/SDKs/MacOSX10.4u.sdk -mmacosx-version-min=10.4"
  73. This requires Mac OS X 10.4 and Xcode 2.4 (or Xcode 2.2 if -arch x86_64 is
  74. omitted, but _not_ Xcode 2.1) and will work on any of the architectures (the
  75. -isysroot flag is only required on PowerPC Tiger).
  76. Note that configure requires CFLAGS to contain a least one architecture that can
  77. be run on the build machine (i.e. ppc on G3/G4, ppc or ppc64 on G5, ppc or i386
  78. on Core and ppc, i386 or x86_64 on Core2/Xeon).
  79. Universal builds of Tcl TEA extensions are also possible with CFLAGS set as
  80. above, they will be [load]able by universal as well as thin binaries of Tcl.
  81. - To enable weak-linking, set the MACOSX_DEPLOYMENT_TARGET environment variable
  82. to the minimal OS version (>= 10.2) the binaries should be able to run on, e.g:
  83.     export MACOSX_DEPLOYMENT_TARGET=10.2
  84. This requires Mac OS X 10.2 and gcc 3.1; if you have gcc 4 or later you can set
  85. CFLAGS instead:
  86.     export CFLAGS="-mmacosx-version-min=10.2"
  87. Support for weak-linking was added to the code for 8.4.14/8.5a5.
  88. Detailed Instructions for building with macosx/Makefile
  89. -------------------------------------------------------
  90. - Unpack the tcl source release archive.
  91. - The following instructions assume the tcl source tree is named "tcl${ver}",
  92. where ${ver} is a shell variable containing the tcl version number (for example
  93. '8.4.12').
  94. Setup the shell variable as follows:
  95. set ver="8.4.12" ;: if your shell is csh
  96. ver="8.4.12"  ;: if your shell is sh
  97. The source tree will be named this way only if you are building from a release
  98. archive, if you are building from CVS, the version numbers will be missing; so
  99. set ${ver} to the empty string instead:
  100. set ver=""  ;: if your shell is csh
  101. ver=""  ;: if your shell is sh
  102. - The following steps will build Tcl from the Terminal, assuming you are located
  103. in the directory containing the tcl source tree:
  104. make -C tcl${ver}/macosx
  105. and the following will then install Tcl onto the root volume (admin password
  106. required):
  107. sudo make -C tcl${ver}/macosx install
  108. if you don't have the admin password, you can install into your home directory,
  109. instead by passing an INSTALL_ROOT argument to make:
  110. make -C tcl${ver}/macosx install INSTALL_ROOT="${HOME}/"
  111. - The default Makefile targets will build _both_ debug and optimized versions of
  112. the Tcl framework with the standard convention of naming the debug library
  113. Tcl.framework/Tcl_debug.
  114. This allows switching to the debug libraries at runtime by setting
  115. export DYLD_IMAGE_SUFFIX=_debug
  116. (c.f. man dyld for more details)
  117. If you only want to build and install the debug or optimized build, use the
  118. 'develop' or 'deploy' target variants of the Makefiles, respectively.
  119. For example, to build and install only the optimized versions:
  120. make -C tcl${ver}/macosx deploy
  121. sudo make -C tcl${ver}/macosx install-deploy