Mailing List Archive

python/dist/src/Mac ReadMe,1.43,1.44
Update of /cvsroot/python/python/dist/src/Mac
In directory usw-pr-cvs1:/tmp/cvs-serv27485

Modified Files:
ReadMe
Log Message:
Backport of select parts of release22-maint (up to 1.38.4.2.2.3).


Index: ReadMe
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/ReadMe,v
retrieving revision 1.43
retrieving revision 1.44
diff -C2 -d -r1.43 -r1.44
*** ReadMe 22 Apr 2002 13:56:25 -0000 1.43
--- ReadMe 23 Apr 2002 19:50:53 -0000 1.44
***************
*** 1,3 ****
! How to install Python 2.2 on your Macintosh
---------------------------------------------

--- 1,3 ----
! How to install Python 2.2.1 on your Macintosh
---------------------------------------------

***************
*** 36,96 ****
If you want 68k support you will have get MacPython 1.5.2.

- Toolbox module reorganization and more
- --------------------------------------
-
- You can safely skip this section if this is your first encounter with MacPython.
-
- This release has a new organization of the mac-specific modules, and in
- general brings the MacPython folder structure more in line with
- unix-Python. This is not only a good idea, it will also immensely
- facilitate moving MacPython functionality to an OSX Python that is based
- on Mach-O and the unix-Python distribution. But don't worry: MacPython
- is definitely not dead yet, and the hope is that the transition will be
- as seamless as possible.
-
- First a change that should not cause too much concern: :Mac:Plugins has
- gone, and most of the dynamically loaded modules have moved to
- :Lib:lib-dynload.
-
- Second, and more important: the toolbox modules, such as Res and
- Resource, have moved to a Carbon package. So, in stead of "import Res"
- you should now say "from Carbon import Res" and in stead of "from Res
- import *" you should use "from Carbon.Res import *". For the lifetime of
- MacPython 2.2 there is a folder :Mac:Lib:lib-compat on sys.path that
- contains modules with the old names which imports the new names after
- issuing a warning.
-
- Note that although the package is called Carbon the modules work fine under
- classic PPC, and they are normal classic modules. Also note that some
- modules you may think of as toolbox modules (such as Waste) really are not,
- and they are not in the Carbon package.
-
- Also, all toolbox modules have been updated to Universal Headers 3.4, and
- are (for classic PPC) weak-linked against InterfaceLib so that they should
- work on all systems back to MacOS 8.1. Calling an unimplemented function will
- raise an exception, not crash your interpreter.
-
- Another change related to the OSX growth path is that there is a new module
- macresource that you can use to easily open a resource file accompanying your
- script. Use "macresource.need("DLOG", MY_DIALOG_ID, "name.rsrc") and if the
- given resource is not available (it _is_ available if your script has been
- turned into an applet) the given resource file will be opened. This method will
- eventually also contain the magic needed to open the resource file on
- OSX MachO Python.
-
- Another feature to help with the OSX transition is that if you open a
- textfile for reading MacPython will now accept either unix linefeeds
- (LF, '\n') or Macintosh linefeeds (CR, '\r') and present both of them
- as '\n'. This is done on a low level, so it works for files opened by
- scripts as well as for your scripts and modules itself. This can be
- turned off with a preference/startup option.
-
- But:
- - this works only for input, and there's no way to find out what the original
- linefeed convention of the file was.
- - Windows \r\n linefeeds are not supported and get turned into \n\n.
- - in 2.3 this feature will be replaced by a more general, platform independent
- way of handling files with foreign newline conventions.
-
What to install
---------------
--- 36,39 ----
***************
*** 163,166 ****
--- 106,126 ----
ways.

+ OSX Multiple users note
+ -----------------------
+
+ Interaction with Mac OS X multiple users has been tested only very lightly.
+ If you install as a privileged user everything installs fine.
+
+ If you install as a non-privileged user everything should install in your local
+ per-user folders. But: as there is no global PythonCore you can only run applets
+ if they reside in your toplevel Python folder.
+
+ 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
+ be fine.
+
Uninstalling
------------
***************
*** 168,172 ****
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 Preferences" file in the Python subfolder
in the Preferences folder. All the rest of Python lives in the folder
you installed in.
--- 128,132 ----
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
in the Preferences folder. All the rest of Python lives in the folder
you installed in.
***************
*** 216,222 ****
are lost and you have to set them again.

! After you are satisfied that 2.2 works as expected you can trash
anything in the system folder that has "python" in the name and not
! "2.2".

The ConfigurePython... applets will try to detect incompatible
--- 176,182 ----
are lost and you have to set them again.

! After you are satisfied that 2.2.1 works as expected you can trash
anything in the system folder that has "python" in the name and not
! "2.2.1".

The ConfigurePython... applets will try to detect incompatible