<html>
<head>
<title>MacEnthon Readme</title>
</head>
<body>

<h1>MacEnthon 0.0 Prerelease</h1>

<p>Welcome to MacEnthon! As you can tell from the version number, this is an
unpolished prerelease. A fair number of things are broken, undocumented, or
suboptimal. Some packages are in development, others don't work as well on the
Mac as on other platforms, and sometimes I'm just a bozo. 
</p>

<p>A copy of this document will be installed to
<code>/Developer/Documentation/Enthon/ReadMe.html</code> for future reference.
</p>

<p>Please report all bugs to the 
<a href="https://www.enthought.com/roundup/enthon/">Enthon issue tracker</a>. Add
the topic "MacEnthon" and assign the bug to the user "rkern" to each issue,
please.
</p>

<p>At this time, the installer targets OS X 10.3 (Panther) and the pre-installed
"framework" build of Python 2.3.0. Jaguar is not supported. Other Pythons, such as
those from <a href="http://fink.sourceforge.net">Fink</a>, 
<a href="http://darwinports.opendarwin.org">Darwinports</a>, or a self-installed
Python, are not supported.
</p>

<p>I have tried to collect the documentation for each package. Some packages are
not documented for reasons ranging from "the OS X package was made by someone
else who didn't include the documentation" to "I was too lazy to track it down."
Where possible, the documentation was placed into package-specific folders under
<code>/Developer/Documentation/Enthon</code>. A few packages place their
documentation into <code>/Developer/Python</code> because that is where their
packagers decided to place them. The real release will probably rationalize this
setup.
</p>

<p>Command-line scripts have been placed into <code>/usr/local/bin</code>. If
you wish to use these scripts, please add <code>/usr/local/bin</code> to your
<code>PATH</code> environment variable.
</p>

<p>I would like to thank <a href="http://bob.pythonmac.org/">Bob Ippolito</a>
for his ground-breaking work on <a
href="http://pythonmac.org/wiki/py2app">py2app</a> which has made this
distribution possible.
</p>

<h2>Software</h2>

<p><b>Note:</b> the licenses listed here are sometimes only approximate. Many
projects use trivial variants of well-known licenses (for example, the 
<a href="http://www.opensource.org/licenses/bsd-license.php">BSD</a> and 
<a href="http://www.opensource.org/licenses/mit-license.php">X/MIT</a>
licenses). I use the term "BSD-like" below to signify such licenses (and
probably some authentic BSD licenses, too). Also, many
projects include code under several different licenses.
If you need to know the license of a piece of code precisely, please see the
corresponding package's documentation. Ususally, the license is in a file named
<code>COPYING</code>, <code>License.txt</code>, <code>legal.txt</code> and the
like. If you cannot identify the license, please file a 
<a href="https://www.enthought.com/roundup/enthon/">bug report</a>.
</p>

<p>To the best of my ability to determine, all of the code here is 
<a href="http://www.opensource.org/">open source</a> and free
to use. If you intend to redistribute these packages or develop software that
uses these packages, you should read the licenses of those packages. Most have
requirements that you are obliged to follow.
</p>

<p>The source code that I used to build these packages is available on <a
href="mailto:rkern@enthought.com">request</a>.
</p>

<table>
<tr>
 <td><b>Package</b>
 <td><b>License</b>
 <td><b>Tracked Version</b>
</tr>
<tr>
 <td><a href="http://www.scipy.org">Scipy</a>
 <td>BSD-like
 <td>CVS as of 2005-03-25 (using ATLAS)
</tr>
<tr>
 <td><a href="http://numeric.scipy.org">Numeric</a>
 <td>BSD-like
 <td>23.8 (using vecLib for LinearAlgebra)
</tr>
<tr>
 <td><a
href="http://www.stsci.edu/resources/software_hardware/numarray">numarray</a>
 <td>BSD-like
 <td>1.2.3
</tr>
<tr>
 <td><a href="http://starship.python.net/~hinsen/ScientificPython/"> 
ScientificPython</a>
 <td>BSD-like
 <td>2.4.9 (no MPI support at this time)
</tr>
<tr>
 <td><a href="http://www.pythonware.com/products/pil/"> 
PIL</a>
 <td>BSD-like
 <td>1.1.5c1
</tr>
<tr>
 <td><a href="http://www.python.org">readline
</a>
 <td>GPL
 <td>2.3.5 (from the Python standard library)
</tr>
<tr>
 <td><a href="http://www.python.org">bsddb</a>
 <td>PSF
 <td>2.3.5 (from the Python standard library)
</tr>
<tr>
 <td><a href="http://ipython.scipy.org">IPython</a>
 <td>BSD-like
 <td>CVS as of 2005-03-24
</tr>
<tr>
 <td><a href="http://www.wxpython.org">wxPython</a>
 <td>wxPython license (LGPL with exception)
 <td>2.4.2.4 and 2.5.4.1-unicode; we use 
<a href="http://wiki.wxpython.org/index.cgi/MultiVersionInstalls">multi-version
installs</a> with a default of the 2.5 version; change the contents of
<code>/Library/Python/2.3/wx.pth</code> to point to the 2.4 directory if you
want to use 2.4 as the default
</tr>
<tr>
 <td><a href="http://pyobjc.sourceforge.net/">PyObjC</a>
 <td>BSD-like
 <td>SVN as of 2005-03-24 (essentially 1.3 beta)
</tr>
<tr>
 <td><a href="http://matplotlib.sourceforge.net">matplotlib</a>
 <td>PSF-like
 <td>0.73.1
</tr>
<tr>
 <td><a href="http://www.python.org">Tkinter</a>
 <td>PSF
 <td>2.3.5 (from the Python standard library)
</tr>
<tr>
 <td><a href="http://pmw.sourceforge.net/">Pmw</a>
 <td>BSD-like
 <td>1.2
</tr>
<tr>
 <td><a href="http://svn.enthought.com/svn/enthought/branches/converge/">enthought</a>
 <td>BSD-like
 <td>SVN as of 2005-03-24; please note that much of this is pre-alpha and should
not be relied upon
<tr>
 <td><a href="http://pyopengl.sourceforge.net">PyOpenGL</a>
 <td>BSD-like
 <td>2.0.2.01
</tr>
<tr>
 <td><a href="http://cens.ioc.ee/projects/f2py2e">f2py</a>
 <td>BSD-like
 <td>2.45.241_1926
</tr>
<tr>
 <td><a href="http://mayavi.sourceforge.net">MayaVi</a>
 <td>BSD-like
 <td>1.4
</tr>
<tr>
 <td><a href="http://http://public.kitware.com/VTK">VTK</a>
 <td>BSD-like
 <td>4.4 (no Patented)
</tr>
<tr>
 <td><a href="http://pysqlite.org">PySQLite</a>
 <td>BSD-like
 <td>1.1 (uses <a href="http://www.sqlite.org/">SQLite 3</a>)
</tr>
<tr>
 <td><a href="http://www.swig.org">SWIG</a>
 <td>BSD-like
 <td>1.3.24
</tr>
<tr>
 <td><a href="http://nz.cosc.canterbury.ac.nz/~greg/python/Pyrex">Pyrex</a>
 <td>BSD-like
 <td>0.9.3
</tr>
<tr>
 <td><a href="http://twistedmatrix.com/">Twisted</a>
 <td>BSD-like
 <td>2.0
</tr>
<tr>
 <td><a href="http://pytables.sourceforge.net/html/WelcomePage.html">PyTables</a>
 <td>BSD-like
 <td>0.9.1
</tr>
<tr>
 <td><a href="http://www.scons.org/">SCons</a>
 <td>BSD-like
 <td>0.96.1
</tr>
<tr>
 <td><a href="http://www.reportlab.org/">ReportLab</a>
 <td>BSD and LGPL for renderPM
 <td>1.20 (and the extensions 
<a href="http://www.reportlab.org/downloads.html#rl_accel">_rl_accel</a> and
<a href="http://www.reportlab.org/downloads.html#renderPM">renderPM</a>)
</tr>
<tr>
 <td><a href="http://peak.telecommunity.com/PyProtocols.html">PyProtocols</a>
 <td>ZPL or PSF (oy!)
 <td>0.9.3 (can anyone <a href="mailto:rkern@enthought.com">tell me</a> if we
should be packaging this version or CVS with all of its niftyness?)
</tr>
<tr>
 <td><a href="http://pychecker.sourceforge.net/">PyChecker</a>
 <td>BSD
 <td>0.8.14
</tr>
<tr>
 <td><a
href="http://www.egenix.com/files/python/eGenix-mx-Extensions.html#mxBASE">egenix mx-Base</a>
 <td>
 <a href="http://www.egenix.com/files/python/mxLicense.html#Public">eGenix.com
 Public License</a>
 <td>2.0.6
 </tr>
<tr>
 <td><a
href="http://www.egenix.com/files/python/eGenix-mx-Extensions.html#mxEXPERIMENTAL">egenix
mx-Eperimental</a>
 <td>
<a href="http://www.egenix.com/files/python/mxLicense.html#Public">eGenix.com
Public License</a>
 <td>0.9.0
</tr>
<tr>
 <td><a href="http://pymc.sourceforge.net/">PyMC</a>
 <td>GPL
 <td>0.8
</tr>
<tr>
 <td><a href="http://mdp-toolkit.sourceforge.net/">MDP</a>
 <td>LGPL
 <td>1.0.0
</tr>
<tr>
 <td><a href="http://www.zope.org/Wikis/ZODB">ZODB3</a>
 <td>ZPL
 <td>3.3 (can anyone <a href="mailto:rkern@enthought.com">tell me</a> if this is the version we should be using?)
</tr>
<tr>
 <td><a href="http://pyxml.sourceforge.net/">PyXML</a>
 <td>BSD-like
 <td>0.8.4
</tr>
<tr>
 <td><a href="http://www.biopython.org">BioPython</a>
 <td>BSD-like
 <td>1.40b
</tr>
<tr>
 <td><a href="http://www.biopython.org">BioPython-CORBA</a>
 <td>BSD-like
 <td>0.3.0
</tr>
<tr>
 <td><a href="http://www.pygame.org/">pygame</a>
 <td>LGPL
 <td>1.7 beta (with Bob Ippolito's patched SDL frameworks)
</tr>
<tr>
 <td><a href="http://effbot.org/zone/element-index.htm">elementtree</a>
 <td>BSD-like
 <td>1.2.6 (with cElementTree 1.0.2)
</tr>
<tr>
 <td><a href="http://starship.python.net/crew/theller/ctypes/">ctypes</a>
 <td>BSD-like
 <td>0.9.6
</tr>
<tr>
 <td><a href="http://www.equi4.com/metakit/python.html">metakit</a>
 <td>BSD-like
 <td>2.4.9.3
</tr>
<tr>
 <td><a href="http://pyro.sourceforge.net">Pyro</a>
 <td>BSD-like
 <td>3.4
</tr>
<tr>
 <td><a
href="http://bob.pythonmac.org/archives/2005/02/02/python23compat/">Python23Compat</a>
 <td>PSF
 <td>2.4, sorta; it's some useful stuff in the Python 2.4 standard library
back-ported to Python 2.3
</tr>
<tr>
 <td><a href="http://simpy.sourceforge.net/">SimPy</a>
 <td>LGPL
 <td>1.5.1
</tr>
<tr>
 <td><a href="http://www.zope.org/Products/ZopeInterface">zope.interface</a>
 <td>ZPL
 <td>3.0.1
</tr>
<tr>
 <td><a href="http://docutils.sourceforge.net">docutils</a>
 <td>BSD-like
 <td>0.3.7
</tr>
<tr>
 <td><a href="http://elmer.sourceforge.net">elmer</a>
 <td>BSD-like
 <td>1.1.5
</tr>
<tr>
 <td><a href="http://epydoc.sourceforge.net">Epydoc</a>
 <td>BSD-like
 <td>2.1
</tr>
<tr>
 <td><a href="http://www.fnorb.org">Fnorb</a>
 <td>PSF-like
 <td>1.3
</tr>
<tr>
 <td><a href="http://gadfly.sourceforge.net">Gadfly</a>
 <td>BSD-like
 <td>1.0.0
</tr>
</table>

</body>
</html>