summaryrefslogtreecommitdiffstats
path: root/macosx/README
diff options
context:
space:
mode:
Diffstat (limited to 'macosx/README')
-rw-r--r--macosx/README44
1 files changed, 21 insertions, 23 deletions
diff --git a/macosx/README b/macosx/README
index 769ee1f..0aa2ea9 100644
--- a/macosx/README
+++ b/macosx/README
@@ -1,7 +1,7 @@
Tcl/Tk Mac OS X README
----------------------
-RCS: @(#) $Id: README,v 1.24 2007/06/29 03:19:05 das Exp $
+RCS: @(#) $Id: README,v 1.25 2007/09/06 08:07:24 das Exp $
This is the README file for the Mac OS X/Darwin version of Tcl/Tk.
@@ -166,22 +166,20 @@ select based notifier). Note that --enable-aqua is incompatible with
- It is also possible to build with Apple's IDE via the projects in tk/macosx,
take care to only use the project matching your DevTools and OS version:
- * Wish.pbproj for ProjectBuilder on 10.2 and earlier, this has a 'Tk' target
- that simply calls through to the tcl/macosx/GNUMakefile. It requires a
- build of the 'Tcl' target of the tcl/macosx/Tcl.pbproj project.
- * Wish.xcode for Xcode 1.5 on 10.3, this additionally has a native 'tktest'
- target useful for debugging, this target's 'Development' buildstyle
- has ZeroLink and Fix&Continue enabled, use the 'DevelNoFixZL' buildstyle
- if you need a debug build without these features.
- * Wish.xcodeproj for Xcode 2.4 on 10.4 or later, which has the following
- additional build configurations for the 'Tk' and 'tktest' targets:
+ * Wish.pbproj for Xcode or ProjectBuilder on 10.3 and earlier, this has a
+ 'Tk' target that simply calls through to the tcl/macosx/GNUMakefile. It
+ requires a build of the 'Tcl' target of tcl/macosx/Tcl.pbproj.
+ * Wish.xcode Xcode 2.4 on 10.4 and Xcode 2.5 on 10.4 and later, which
+ additionally has a native 'tktest' target useful for debugging, this
+ target's 'Debug' build configuration has ZeroLink and Fix&Continue
+ enabled, use the 'DebugNoFixZL' build configuration if you need a debug
+ build without these features. The following additional build
+ configurations are available for the 'Tk' and 'tktest' targets:
'DebugUnthreaded': debug build with threading turned off.
'DebugMemCompile': debug build with memory and bytecode debugging on.
'DebugLeaks': debug build with PURIFY defined.
'ReleaseUniversal': builds the targets as universal binaries for the
ppc and i386 architectures.
- 'ReleaseUniversal10.5SDK': same as 'ReleaseUniversal' but builds
- against the 10.5 SDK on Leopard (with 10.5 deployment target).
'ReleaseUniversal10.4uSDK': same as 'ReleaseUniversal' but builds
against the 10.4u SDK, required to build universal binaries on
PowerPC Tiger (where the system libraries are not universal).
@@ -190,27 +188,27 @@ take care to only use the project matching your DevTools and OS version:
'ReleasePPC10.2.8SDK': builds for PowerPC with gcc-3.3 against the
10.2.8 SDK, useful to verify on Tiger that building on Jaguar
would succeed.
+ * Wish.xcodeproj for Xcode 3.0 on 10.5 and later, which has the following
+ additional build configuration:
+ 'ReleaseUniversal10.5SDK': same as 'ReleaseUniversal' but builds
+ against the 10.5 SDK on Leopard (with 10.5 deployment target).
+
Notes about the native targets of the Xcode projects:
- * the Xcode 2 project refers to the toplevel tcl and tk source dirs through
+ * the Xcode projects refer to the toplevel tcl and tk source dirs through
the TCL_SRCROOT and TK_SRCROOT user build settings, by default these are
set to the project-relative paths '../../tcl' and '../../tk', if your
source directories are named differently, e.g. '../../tcl8.5', you'll
need to manually change the TCL_SRCROOT and TK_SRCROOT settings by
editing your ${USER}.pbxuser file (located inside the Wish.xcodeproj
bundle directory) with a text editor.
- * XCode 1.5 has a bug that causes Fix&Continue and the Build menu items
- Compile/Preprocess/ShowAssembly to fail in presence of relative paths to
- source files, as a workaround change the Path Type of the 'Tcl Sources'
- and 'Tk Sources' groups to 'Absolute Path' in the groups' Info panel.
- (fixed in Xcode 2.2)
* the native targets need a version of the unix configure scripts with config
headers enabled, this is automatically generated as tcl/macosx/configure
and tk/macosx/configure by the project but that requires 2.59 versions
- of autoconf & autoheader. These are not available on on Mac OS X 10.3 by
+ of autoconf & autoheader. These are not available on Mac OS X 10.5 by
default and need to be installed manually. By default they are assumed
to be installed as /usr/local/bin/autoconf-2.59 and
- /usr/local/bin/autoheader-2.59, set the env vars AUTOCONF and AUTOHEADER
- to their true locations if necessary.
+ /usr/local/bin/autoheader-2.59, set the AUTOCONF and AUTOHEADER build
+ settings in ${USER}.pbxuser to their true locations if necessary.
- To build universal binaries outside of Wish.xcodeproj, set CFLAGS as follows:
export CFLAGS="-arch ppc -arch i386 \
@@ -235,8 +233,8 @@ to the minimal OS version (>= 10.2) the binaries should be able to run on, e.g:
This requires Mac OS X 10.2 and gcc 3.1; if you have gcc 4 or later you can set
CFLAGS instead:
export CFLAGS="-mmacosx-version-min=10.2"
-The Wish.xcodeproj is setup to produce binaries that can run on 10.2 or later,
-except for the 'ReleaseUniversal*' configurations, where they require 10.4.
+The Wish.xcode project is setup to produce binaries that can run on 10.2 or
+later (except for the Univerasl and SDK configurations).
Support for weak-linking was added to the code for 8.4.14/8.5a5.
Detailed Instructions for building with macosx/GNUmakefile