TclTk Aqua Batteries-Included README
Welcome to TclTk Aqua Batteries-Included, a binary distribution of the Mac OS X native Tcl/Tk and over fifty popular extensions.
This page lists all software packages included in the distribution, with links to installed documentation and demos; as well as links to package homepages and wiki pages, where additional docs and sample code are available.
Please direct questions and comments specific to this distribution to the MacTcl List (preferred) or to the distribution maintainer.
For the purpose of usage statistics collection, the TclTkAquaBI distribution installer will attempt to notify the Tcl/Tk Aqua Statistics page after a successful installation, see there for details; the reporting mechanism can be bypassed if desired.
Install Locations
- The Tcl/Tk libraries are installed as frameworks into /Library/Frameworks (including debug versions of library binaries).
- The 'tclsh' and 'wish' command line tools are installed into /usr/bin and a link to the Wish application is installed into /Applications/Utilities.
- The Tcl/Tk documentation is contained in html format inside the frameworks, and is also installed as manpages into /Library/Tcl/man (optional).
- All other files in the distribution (the "Batteries-Included" part), are installed entirely into subdirectories of /Library/Tcl and can be uninstalled by removing that directory.
- BI command line tools such as 'expect' are located in /Library/Tcl/bin; for them to be accessible from Terminal without giving a full path, this directory needs to be added to the shell path; e.g. for tcsh, by adding the following to ~/.login:
set path = ( ${path} /Library/Tcl/bin ) - BI documentation in manpage format is located in /Library/Tcl/man, this directory is searched automatically by 'man' if the shell path has been adjusted as detailed above.
Documentation in other formats is installed into /Library/Tcl/docs. - Many packages come with sample code and demos, they are located in /Library/Tcl/demos.
TclTkAquaBI Details
This distribution was built on @DATE@ from the latest sources available at the time:
Most packages are built from the HEAD of their CVS repositories as of @CVSDATE@ (or from the latest tarballs where there is no CVS access), see cvsTag.conf for details; with some patches applied.
All code in this distribution was compiled with the latest Apple developer tools for Mac OS X @OS@, and will in general not run on earlier version of Mac OS X.
The tools used to build the distribution (including the installer packages & disk images) are available, as well as archives of the exact (unpatched) sources used to build the distribution.
Also at that location are individual tarballs of the binaries and installer packages contained in the distribution; additionally, this contains binaries of Tcl & Tk/X11 built in the standard unix style into /usr/local.
The Tcl/Tk Aqua 8.5a3 alpha release is installed in addition to @SHORTVERS@; both releases coexist peacefully inside the Tcl/Tk frameworks. The default binaries continue to be 8.4, e.g. tclsh is tclsh8.4, and Tcl.framework/Tcl is 8.4; but tclsh8.5, wish8.5, Tcl.framework/Versions/8.5/Tcl etc. are also available, as is the html documentation for 8.5.
Note the presence in the distribution of both Tclkit and the new Wishkit, which allows the running of starkits under either Tk/X11 or Tk/Aqua.
The TclTkAquaBI distribution uses the standard Apple Installer, allowing users to install all or only some of the packages included. The installer is also easily adapted to include only a subset of the bundled packages for building customized distributions.
License & Donations
The TclTkAqua BI distribution is available free of charge for any use permitted under the open-source BSD license, including use in commercial products.
However, given that the ongoing maintenance and improvement of the distribution requires a significant amount of time (one to two man-weeks per release), donations supporting the future development of TclTkAquaBI are certainly greatly appreciated.
A PayPal account is available for donations to the distribution maintainer, or you can donate to the TclTkAqua SourceForge project (to additionally also support the SourceForge infrastructure).
In particular, if you are using or redistributing the prebuilt binaries or installers contained in this distribution as part of a commercial product, please consider supporting TclTkAquaBI; after all such usage of e.g. the free ActiveTcl distribution on other platforms also attracts license fees.
Please note that making a donation does not guarantee that you can expect personal support of any kind for the TclTkAqua distributions.
If you would like to give something back to the community that has produced the software included in this distribution, consider becoming involved in the open-source process by reporting bugs or submitting patches to any of the software project homepages listed below.
Contents of TclTkAqua BI @VERS@
The following packages are included in this distribution:
If you have customized your installation, some local links may be invalid.
Note that this list of packages constitutes a superset of what is contained in ActiveState's ActiveTcl distribution on other platforms.