summaryrefslogtreecommitdiffstats
path: root/Mac/ReadMe
diff options
context:
space:
mode:
authorJack Jansen <jack.jansen@cwi.nl>2000-09-10 12:02:28 (GMT)
committerJack Jansen <jack.jansen@cwi.nl>2000-09-10 12:02:28 (GMT)
commit8a6cdccf218880465366aeca59eb3de92d871dea (patch)
tree318dfadc1cddb62066c01e1d01132997db46145a /Mac/ReadMe
parente61aca7d4a17f231d0058c6be736bc1eea40c081 (diff)
downloadcpython-8a6cdccf218880465366aeca59eb3de92d871dea.zip
cpython-8a6cdccf218880465366aeca59eb3de92d871dea.tar.gz
cpython-8a6cdccf218880465366aeca59eb3de92d871dea.tar.bz2
Updated for 2.0b1
Diffstat (limited to 'Mac/ReadMe')
-rw-r--r--Mac/ReadMe90
1 files changed, 43 insertions, 47 deletions
diff --git a/Mac/ReadMe b/Mac/ReadMe
index b04241b..d177c2f 100644
--- a/Mac/ReadMe
+++ b/Mac/ReadMe
@@ -1,4 +1,4 @@
-How to install Python 1.6a2 on your Macintosh
+How to install Python 2.0b1 on your Macintosh
---------------------------------------------
If this is your first encounter with Python: you definitely need the
@@ -13,39 +13,29 @@ now. The documentation is in HTML format, start with index.html.
Caveats
-------
-This is an alfa version, and for this once it really means that: there
-are quite a few features that have only lightly been tested, and bugs are
-to be expected.
-
-Aside from the general Python 1.6 features like unicode support the
-main new features of this MacPython release is support for multithreading.
-This has had some preliminary testing, but please report any success or failure
-on the mailing list.
-
-This installer installs MacPython for PowerPC only, whether a 68K distribution
-of Python 1.6 will happen is not certain at the moment.
-
-Changes since 1.6a1
--------------------
-
-- All core-Python changes, plus a few from after 1.6a2, approximately as the
- Python CVS tree was at May 5.
-- The threading performance bug has been fixed.
-- Tkinter is included again (yeah!), but only lightly tested. Please report
- findings to the mailing list.
-- macfsn.py is auto-imported on startup (unless disabled with a new option).
- This retrofits macfs.StandardGetFile() and friends to use Navigation Services
- in stead of the old Standard File dialogs.
-- I think all installer problems have been fixed. Please report if not so.
+This is a beta version, so use with caution.
+
+Aside from the general new Python 2.0 features (compared to 1.5.2, there
+was no 1.6 for the macintosh) like unicode support the main new features
+of this MacPython release is support for multithreading. This has had
+some preliminary testing, but please report any success or failure on
+the mailing list.
+
+This installer installs MacPython for PowerPC only, if you really want
+68k support you will have to stay with 1.5.2. Or, if you are willing to
+invest the time and have access to CodeWarrior you are welcome to try
+and build a 68k distribution, most of the projects and sources are
+reasonably up to date (May 2000). Contact me for details.
What to install
---------------
-This installer is PPC only: too many new MacOS features are not available on 68K,
-and doing workarounds, even just #ifdeffing in the code, is too much work for
-me right now. If someone wants to revive 68K-MacPython: please do so. The project
-files still contain the 68K targets (they're simply skipped by the build process)
-so all that is needed is CodeWarrior, a source distribution and commitment.
+This installer is PPC only: too many new MacOS features are not
+available on 68K, and doing workarounds, even just #ifdeffing in the
+code, is too much work for me right now. If someone wants to revive
+68K-MacPython: please do so. The project files still contain the 68K
+targets (they're simply skipped by the build process) so all that is
+needed is CodeWarrior, a source distribution and commitment.
The optional parts in this distribution are
- TK+PIL: Tkinter and support modules, plus Imaging, the Python image manipulation
@@ -54,13 +44,16 @@ The optional parts in this distribution are
than imaging, but has only limited operations on images. There is a bridge
between the packages.
- Numeric: the LLNL Numeric Python extension. All sorts of nifty operations
- on matrices and such.
+ on matrices and such. This is the most recent version from the sourceforge archive.
- Developers kit: all header files and some tools and sample projects to get you started on
writing Python extensions if you have CodeWarrior.
All these except the DevKit are installed with Easy Install.
After the installer finishes it automatically launches the
ConfigurePython applet, to finish configuration of your Python.
+If you have previously installed another copy of 2.0b1 you should manually
+remove your preference file first (but no such action is needed for installing
+beside older MacPythons, and they will live together happily).
If you don't have enough memory: the sizes choosen are somewhat
arbitrary. Try lowering the application sizes in the finder "get info"
@@ -71,14 +64,10 @@ necessary to increase the application size.
After installing
----------------
-The first step thing you could try is to run "compileall.py" to create
-all .pyc files, but this isn't very important, as pyc files are
-created on-the-fly as well. You may also want to skip this step if you
-are low on diskspace.
-
-Next, it is probably a good idea to run the automatic tests. Start
-Python and "import test.autotest". This should not print only one error, about some
-AM/PM format not supported in strftime.
+It is probably a good idea to run the automatic tests. Start
+Python and "import test.autotest". This should print only 2 or 3 errors, about some
+AM/PM format not supported in strftime, about a MemoryError in test_longexp and
+about a memory error in test_zlib.
It will, however, print some messages about optional features
not supported. Also, if you didn't run compileall before autotesting
you may run out of memory the first time you run the
@@ -91,32 +80,39 @@ debugger and other goodies. The alternative is to use PythonInterpreter,
which is the lowlevel interpreter with a console-window only (similar to Unix
Python).
+If your program uses Tkinter you MUST run it under PythonInterpreter, Tkinter
+and IDE are incompatible and your program will fail in strange ways.
+
Uninstalling
------------
Two items are installed in the system folder: the interpreter shared
-library "PythonCore 1.6a2" lives in the Extensions folder and the
-"Python 1.6a2 Preferences" file in the Preferences folder. All the rest
-of Python lives in the folder you installed in.
+library "PythonCore 2.0b1" lives in the Extensions folder and the
+"Python 2.0b1 Preferences" file in the Python subfolder in the
+Preferences folder. All the rest of Python lives in the folder you
+installed in.
Things to see
-------------
Start off at Mac:Demo:index.html. Read at least the first few sections.
-There are also some readme files in the "Read me files" folder that may
+There are also some interesting files in the "Relnotes" folder that may
contain useful information. There is also a first stab at documentation
(plus examples) in the Mac:Demo folder. The toplevel Demo folder has
machine-independent demos.
The Mac:Lib:test folder also has some programs that show simple
capabilities of various modules.
-The "scripts" folder has some sample scripts. Some are useful, some are
+The ":Mac:scripts" folder has some sample scripts. Some are useful, some are
just interesting to look at to see how various things work. The MkDistr,
mkapplet and fullbuild scripts (plus the ones mentioned above) may help
you to understand how to use AppleEvents and various other toolboxes
from python.
+Other mac-specific goodies can be found in :Mac:Tools, of which the IDE sources
+and a CGI framework deserve special mention.
+
The 'img' group of modules, which handles I/O of many different image
formats is included, but without documentation. You can find docs at
ftp://ftp.cwi.nl/pub/jack/python/img (or somewhere around there).
@@ -133,7 +129,7 @@ that this means you can keep your older version around if you are unsure
whether to upgrade. The bad news is that your old preference settings
are lost and you have to set them again.
-After you are satisfied that 1.6a2 works as expected you can trash
+After you are satisfied that 2.0b1 works as expected you can trash
anything in the system folder that has "python" in the name and not
"1.6a2".
@@ -159,8 +155,8 @@ Thanks!
Thanks go to the whole Python community with Guido in the lead, of course.
Mac-specific thanks go to the pythonmac-sig, Just van Rossum, Corran Webster,
-Erik van Blokland, Bill Bedford, Chris Stern, Gordon Worley, Oliver Steele, M. Papillon
-and all the other people who provided feedback, code or both!
+Erik van Blokland, Bill Bedford, Chris Stern, Gordon Worley, Oliver Steele, M. Papillon,
+Steven Majewski and all the other people who provided feedback, code or both!
Feedback
--------