Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.

1 files changed, 41 insertions, 48 deletions

diff --git a/Mac/ReadMe b/Mac/ReadMe
index fd0bfe4..f08ce6e 100644
--- a/Mac/ReadMe
+++ b/Mac/ReadMe
@@ -1,19 +1,25 @@
-How to install Python 2.2.1 on your Macintosh
----------------------------------------------
+How to install MacPython-OS9 2.3a1 on your Macintosh
+----------------------------------------------------
 
-This is a MacPython that can run on classic MacOS (from 8.1
-onwards) and natively on MacOSX. The installer tries to work out whether you can
-use the Carbon version or not. For Mac OS X users: this version of Python
-does not run from the command line, it is a pure "Mac only" app. Use the standard
-unix Python from the commandline, the two Pythons will be merged in the future.
+This is a MacPython that can run on Mac OS 8.6 with CarbonLib
+installed, Mac OS 9 and Mac OS X. It is the direct successor of MacPython 2.2.
 
-You should definitely read the Relnotes file too, and the section below about
-toolbox module reorganization. You should also read :Misc:NEWS, which lists
-the general (non-mac-dependent) new features of this Python release.
+For Mac OS X users: you are probably better off with the normal unix distribution
+of Python. That version also runs from the commandline, and if you do a framework
+build it will contain all the functionality of this version too. A prebuilt
+version will be available starting with the beta distributions.
 
-A special note about the active installer: do not background it, it may hang
-your machine. This is a general problem with Vise active installers, MindVision
-are working on it.
+If you are upgrading from a previous MacPython you should read :Misc:NEWS,
+which lists the new features of this Python release. As of this release
+the Mac-specific release notes have been moved to the "Mac" section of
+the general NEWS file.
+
+Two changes since 2.2 deserve special mention:
+- Most Mac-specific modules have moved to :Lib:plat-mac. :Mac:Lib now contains
+  only modules that are not shared with MacPython-OSX 2.3.
+- macfs is now a pure Python wrapper module around various modules in the
+  Carbon package. For 2.3a1 only this wrapping is incomplete: fsspec.SetDates()
+  does not work yet. If you encounter any other problems please report them.
 
 ------
 
@@ -28,10 +34,8 @@ Mac-specific documentation is included in this distribution in folder
 Mac:Demo. The documentation is sparse, but it will have to serve for
 now. The documentation is in HTML format, start with index.html.
 
-This installer installs MacPython for classic PPC MacOS, MacPython for Carbon
-(OS X, OS 9 or OS 8 with CarbonLib installed) or both, depending on your
-configuration. By selecting custom install you can bypass these tests and
-install what you want.
+If you want a MacPython that runs on systems without Carbon support (8.1
+up to 8.6 without CarbonLib) you should get MacPython 2.2.2.
 
 If you want 68k support you will have get MacPython 1.5.2.
 
@@ -39,29 +43,20 @@ What to install
 ---------------
 
 The optional parts in this distribution are
-- TK+PIL: Tkinter and support modules, plus Imaging, the Python image
-  manipulation package (allows you to read, write and display images and
-  do lots of operations on them). 
-  For Carbon MacPython you only get PIL: there is no Tcl/Tk for Carbon yet.
-  This is the reason Classic MacPython is also installed on MacOSX: it
-  allows you to run Tkinter applications, albeit in the Classic box.
+- PIL: the Python image manipulation package (allows you to read, write
+  and display images and do lots of operations on them). Tkinter is no
+  longer supported, a working Carbon version is Tk is not available.
 - img: another imaging package. Has more file format support and is faster
   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. This is the most recent version from the
-  sourceforge archive.
-  Numeric has moved from Extensions to :Lib:site-python, by the way,
-  see the release notes.
+  on matrices and such. This is version 22.
 - 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 appropriate
-ConfigurePython applet, to finish configuration of your Python. If you
-run MacOS9 or later (or 8 with CarbonLib installed) you can switch
-back and forth between the classic and Carbon versions of Python by
-running either ConfigurePythonClassic or ConfigurePythonCarbon.
+After the installer finishes it automatically launches the
+ConfigurePython applet, to finish configuration of your Python. 
 
 Moving your Python installation after installing is generally not a
 good idea.  If you have to do this anyway you should remove your
@@ -80,8 +75,10 @@ After installing
 It is probably a good idea to run the automatic tests. Start
 Python and "import test.regrtest ; test.regrtest.main()". 
 
-test_frozen will fail in MacPython because of different handling on
-frozen modules. This should not be a problem in normal use.
+test_httplib fails with an unexpected output error, 
+this problem is being investigated.
+
+test_socket fails, this problem is being investigated.
 
 Three tests will fail on MacOS9 with MemoryErrors:
 test_longexp, test_sha and test_zlib (on MacOSX these should pass).
@@ -119,19 +116,19 @@ If you install as a privileged user and then try to run
 Python as another (non-privileged) user you may encounter a problem with
 not having a preference file: the symptom is failing to import all sorts
 of standard modules. If you remove your per-user Python preference files
-(in ~/Library/Preferences) and then run PythonIntpreter once everything should
+(in ~/Library/Preferences) and then run PythonInterpreter once everything should
 be fine.
 
 Uninstalling
 ------------
 
-Up to three items are installed in the system folder: the interpreter shared
-libraries PythonCore and PythonCoreCarbon live in the Extensions
-folder and the "Python 2.2.1 Preferences" file in the Python subfolder
+Up to three items are installed in the MacOS 8 or 9 system folder: the interpreter
+shared library PythonCore lives in the Extensions
+folder and the "Python 2.3a1 Preferences" file in the Python subfolder
 in the Preferences folder. All the rest of Python lives in the folder
 you installed in.
 
-On OSX the libraries are installed in /Library/CFMSupport. The ConfigurePython
+On OSX the library is installed in /Library/CFMSupport. The ConfigurePython
 applets will complain if you have no right to create the libraries there
 (you need Admin privileges). This has one consequence: you will not be able to
 run applets unless they reside in the MacPython folder (such as the IDE or
@@ -143,12 +140,8 @@ Things to see
 
 Start off at Mac:Demo:index.html. Read at least the first few sections.
 
-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.
+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:scripts" folder has some sample scripts. Some are useful,
 some are just interesting to look at to see how various things
@@ -175,11 +168,11 @@ 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 2.2.1 works as expected you can trash
+After you are satisfied that 2.3a1 works as expected you can trash
 anything in the system folder that has "python" in the name and not
-"2.2.1".
+"2.3a1".
 
-The ConfigurePython... applets will try to detect incompatible
+The ConfigurePython applet will try to detect incompatible
 preferences files and offer to remove them. This means that re-running
 ConfigurePython after a second install of the same MacPython version
 (or after moving the Python folder) should fix things up correctly.