annotate Mac/ReadMe @ 27998:e27f58a50737 legacy-trunk

SF bug #690377: Dud footnote reference in distutils docs
author Raymond Hettinger <python@rcn.com>
date Fri, 21 Feb 2003 02:47:09 +0000
parents eb6b36b26e8d
children 21a50c308db4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
1 How to install MacPython-OS9 2.3a1 on your Macintosh
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
2 ----------------------------------------------------
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
3
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
4 This is a MacPython that can run on Mac OS 8.6 with CarbonLib
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
5 installed, Mac OS 9 and Mac OS X. It is the direct successor of MacPython 2.2.
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
6
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
7 For Mac OS X users: you are probably better off with the normal unix distribution
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
8 of Python. That version also runs from the commandline, and if you do a framework
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
9 build it will contain all the functionality of this version too. A prebuilt
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
10 version will be available starting with the beta distributions.
16649
8d8509617874 2.1a2 distribution files.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16174
diff changeset
11
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
12 If you are upgrading from a previous MacPython you should read :Misc:NEWS,
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
13 which lists the new features of this Python release. As of this release
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
14 the Mac-specific release notes have been moved to the "Mac" section of
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
15 the general NEWS file.
16649
8d8509617874 2.1a2 distribution files.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16174
diff changeset
16
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
17 Two changes since 2.2 deserve special mention:
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
18 - Most Mac-specific modules have moved to :Lib:plat-mac. :Mac:Lib now contains
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
19 only modules that are not shared with MacPython-OSX 2.3.
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
20 - macfs is now a pure Python wrapper module around various modules in the
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
21 Carbon package. For 2.3a1 only this wrapping is incomplete: fsspec.SetDates()
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
22 does not work yet. If you encounter any other problems please report them.
17045
ff75c382f0d3 Files for second 2.1b1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17001
diff changeset
23
16649
8d8509617874 2.1a2 distribution files.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16174
diff changeset
24 ------
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
25
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
26 If this is your first encounter with Python: you definitely need the
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
27 common user documentation (common to all platforms). You can find this
15278
11676ddaff01 Ready for 2.0
Jack Jansen <jack.jansen@cwi.nl>
parents: 15190
diff changeset
28 (in various forms) on www.pythonlabs.com, www.python.org and
11676ddaff01 Ready for 2.0
Jack Jansen <jack.jansen@cwi.nl>
parents: 15190
diff changeset
29 ftp.python.org. Through there, or via
11676ddaff01 Ready for 2.0
Jack Jansen <jack.jansen@cwi.nl>
parents: 15190
diff changeset
30 http://www.cwi.nl/~jack/macpython.html you can also find the most recent
11676ddaff01 Ready for 2.0
Jack Jansen <jack.jansen@cwi.nl>
parents: 15190
diff changeset
31 MacPython distribution.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
32
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
33 Mac-specific documentation is included in this distribution in folder
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
34 Mac:Demo. The documentation is sparse, but it will have to serve for
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
35 now. The documentation is in HTML format, start with index.html.
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
36
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
37 If you want a MacPython that runs on systems without Carbon support (8.1
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
38 up to 8.6 without CarbonLib) you should get MacPython 2.2.2.
7030
05e0e499014f Release notes and readme for 1.5b3
Jack Jansen <jack.jansen@cwi.nl>
parents: 6463
diff changeset
39
21560
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
40 If you want 68k support you will have get MacPython 1.5.2.
14564
bcf23b52b02f Added a note about getting CarbonLib as a way to get a new Appearance/NavServices. Added Luc Lefebvre to the thanks-list.
Jack Jansen <jack.jansen@cwi.nl>
parents: 14515
diff changeset
41
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
42 What to install
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
43 ---------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
44
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
45 The optional parts in this distribution are
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
46 - PIL: the Python image manipulation package (allows you to read, write
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
47 and display images and do lots of operations on them). Tkinter is no
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
48 longer supported, a working Carbon version is Tk is not available.
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
49 - img: another imaging package. Has more file format support and is faster
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
50 than imaging, but has only limited operations on images. There is a bridge
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
51 between the packages.
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
52 - Numeric: the LLNL Numeric Python extension. All sorts of nifty operations
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
53 on matrices and such. This is version 22.
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
54 - Developers kit: all header files and some tools and sample projects
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
55 to get you started on writing Python extensions if you have CodeWarrior.
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
56 All these except the DevKit are installed with Easy Install.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
57
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
58 After the installer finishes it automatically launches the
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
59 ConfigurePython applet, to finish configuration of your Python.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
60
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
61 Moving your Python installation after installing is generally not a
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
62 good idea. If you have to do this anyway you should remove your
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
63 preference file, run ConfigurePython and remove all .pyc
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
64 files. (there's a script zappyc.py that does the latter).
15407
375229c3ac0d Added a note about removing preferences and .pyc files when you move the Python installation.
Jack Jansen <jack.jansen@cwi.nl>
parents: 15278
diff changeset
65
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
66 If you don't have enough memory: the sizes choosen are somewhat
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
67 arbitrary, and they are as high as they are so that test.autotest runs
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
68 with fewer problems. An average Python program can make do with much
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
69 less memory. Try lowering the application sizes in the finder "get
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
70 info" window, and seeing whether the resulting python is still usable.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
71
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
72 After installing
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
73 ----------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
74
14501
58ba90e4e985 Updated for 2.0b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 13639
diff changeset
75 It is probably a good idea to run the automatic tests. Start
19811
38c12faf612a Final tweaks for 2.2a3 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 19569
diff changeset
76 Python and "import test.regrtest ; test.regrtest.main()".
15190
656d434388c8 Updated for 2.0c1
Jack Jansen <jack.jansen@cwi.nl>
parents: 14822
diff changeset
77
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
78 test_httplib fails with an unexpected output error,
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
79 this problem is being investigated.
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
80
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
81 test_socket fails, this problem is being investigated.
21113
ed3dce17fc79 Merged changes made on r22b2-branch between r22b2 and r22b2-mac (the
Jack Jansen <jack.jansen@cwi.nl>
parents: 20785
diff changeset
82
19811
38c12faf612a Final tweaks for 2.2a3 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 19569
diff changeset
83 Three tests will fail on MacOS9 with MemoryErrors:
20638
6f2cb18068dd Tweaks for MacPython 2.2b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 19811
diff changeset
84 test_longexp, test_sha and test_zlib (on MacOSX these should pass).
17237
390a8315d634 Updated for 2.1b2 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17045
diff changeset
85
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
86 If you increase the PythonInterpreter memory partition size they will
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
87 pass (but for longexp you have to increase it by an incredible amount,
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
88 400MB is rumoured). It will, however, print some messages about
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
89 optional features not supported. You should not worry about these,
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
90 they are modules that are supported by Python on other
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
91 platforms. Also, if you didn't run compileall before autotesting you
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
92 may run out of memory the first time you run the tests. test_socket
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
93 may also fail if you have no internet connection. Please also read the
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
94 Relnotes file for other minor problems with this distribution.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
95
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
96 Using Python is most easily done from the IDE, which has a builtin
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
97 editor, debugger and other goodies. The alternative is to use
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
98 PythonInterpreter, which is the lowlevel interpreter with a
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
99 console-window only (similar to Unix Python).
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
100
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
101 If your program uses Tkinter you MUST run it under PythonInterpreter,
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
102 Tkinter and IDE are incompatible and your program will fail in strange
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
103 ways.
14501
58ba90e4e985 Updated for 2.0b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 13639
diff changeset
104
23245
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
105 OSX Multiple users note
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
106 -----------------------
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
107
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
108 Interaction with Mac OS X multiple users has been tested only very lightly.
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
109 If you install as a privileged user everything installs fine.
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
110
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
111 If you install as a non-privileged user everything should install in your local
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
112 per-user folders. But: as there is no global PythonCore you can only run applets
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
113 if they reside in your toplevel Python folder.
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
114
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
115 If you install as a privileged user and then try to run
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
116 Python as another (non-privileged) user you may encounter a problem with
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
117 not having a preference file: the symptom is failing to import all sorts
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
118 of standard modules. If you remove your per-user Python preference files
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
119 (in ~/Library/Preferences) and then run PythonInterpreter once everything should
23245
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
120 be fine.
e0470f2dd410 Backport of select parts of release22-maint (up to 1.38.4.2.2.3).
Jack Jansen <jack.jansen@cwi.nl>
parents: 23221
diff changeset
121
6463
0b2bcf0424a0 Updated for 1.5a4
Jack Jansen <jack.jansen@cwi.nl>
parents: 6163
diff changeset
122 Uninstalling
0b2bcf0424a0 Updated for 1.5a4
Jack Jansen <jack.jansen@cwi.nl>
parents: 6163
diff changeset
123 ------------
0b2bcf0424a0 Updated for 1.5a4
Jack Jansen <jack.jansen@cwi.nl>
parents: 6163
diff changeset
124
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
125 Up to three items are installed in the MacOS 8 or 9 system folder: the interpreter
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
126 shared library PythonCore lives in the Extensions
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
127 folder and the "Python 2.3a1 Preferences" file in the Python subfolder
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
128 in the Preferences folder. All the rest of Python lives in the folder
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
129 you installed in.
6463
0b2bcf0424a0 Updated for 1.5a4
Jack Jansen <jack.jansen@cwi.nl>
parents: 6163
diff changeset
130
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
131 On OSX the library is installed in /Library/CFMSupport. The ConfigurePython
21560
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
132 applets will complain if you have no right to create the libraries there
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
133 (you need Admin privileges). This has one consequence: you will not be able to
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
134 run applets unless they reside in the MacPython folder (such as the IDE or
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
135 EditPythonPrefs). If you try to run an applet stored elsewhere you will
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
136 get a "Cannot locate PythonCore" error message.
17633
7f5e3e6b2a39 Files for 2.1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17237
diff changeset
137
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
138 Things to see
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
139 -------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
140
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
141 Start off at Mac:Demo:index.html. Read at least the first few sections.
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
142
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
143 There is also a first stab at documentation (plus examples) in the
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
144 Mac:Demo folder. The toplevel Demo folder has machine-independent demos.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
145
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
146 The ":Mac:scripts" folder has some sample scripts. Some are useful,
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
147 some are just interesting to look at to see how various things
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
148 work. The MkDistr, mkapplet and fullbuild scripts (plus the ones
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
149 mentioned above) may help you to understand how to use AppleEvents and
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
150 various other toolboxes from python.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
151
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
152 Other mac-specific goodies can be found in :Mac:Tools, of which the
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
153 IDE sources and a CGI framework deserve special mention.
14501
58ba90e4e985 Updated for 2.0b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 13639
diff changeset
154
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
155 The 'img' group of modules, which handles I/O of many different image
8158
b1b26e0e0a0a Updated for 1.5.1
Jack Jansen <jack.jansen@cwi.nl>
parents: 7426
diff changeset
156 formats is included, but without documentation. You can find docs at
b1b26e0e0a0a Updated for 1.5.1
Jack Jansen <jack.jansen@cwi.nl>
parents: 7426
diff changeset
157 ftp://ftp.cwi.nl/pub/jack/python/img (or somewhere around there).
b1b26e0e0a0a Updated for 1.5.1
Jack Jansen <jack.jansen@cwi.nl>
parents: 7426
diff changeset
158
b1b26e0e0a0a Updated for 1.5.1
Jack Jansen <jack.jansen@cwi.nl>
parents: 7426
diff changeset
159 Finally there is a Mac:Contrib folder which contains some contributed
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
160 software.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
161
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
162 Upgrading from older Python releases
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
163 ------------------------------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
164
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
165 Python releases are independent of each other, with separate
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
166 Preferences files, shared library names, etc. The good news is that
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
167 this means you can keep your older version around if you are unsure
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
168 whether to upgrade. The bad news is that your old preference settings
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
169 are lost and you have to set them again.
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
170
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
171 After you are satisfied that 2.3a1 works as expected you can trash
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
172 anything in the system folder that has "python" in the name and not
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
173 "2.3a1".
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
174
27158
eb6b36b26e8d Merging the various tweaks for MacPython-OS9 2.3a1 back into the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 24888
diff changeset
175 The ConfigurePython applet will try to detect incompatible
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
176 preferences files and offer to remove them. This means that re-running
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
177 ConfigurePython after a second install of the same MacPython version
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
178 (or after moving the Python folder) should fix things up correctly.
17237
390a8315d634 Updated for 2.1b2 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17045
diff changeset
179
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
180 The installer
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
181 -------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
182
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
183 The installer for this product was created using Installer VISE
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
184 from MindVision Software. For more information on Installer VISE,
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
185 contact:
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
186 MindVision Software
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
187 7201 North 7th Street
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
188 Lincoln, NE 68521-8913
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
189 Voice: 402-477-3269
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
190 Fax: 402-477-1395
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
191 Internet: mindvision@mindvision.com
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
192 http://www.mindvision.com
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
193
21384
c44c911606a4 fixed typo in my email address
Just van Rossum <just@letterror.com>
parents: 21113
diff changeset
194 Just van Rossum <just@letterror.com> created the initial version of the
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
195 installer (with Installer Vise Lite), and Jack worked from there.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
196
12460
e5b31acb10ce Added a couple of contributors. Still needs work for the next distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12302
diff changeset
197 Thanks!
e5b31acb10ce Added a couple of contributors. Still needs work for the next distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12302
diff changeset
198 -------
e5b31acb10ce Added a couple of contributors. Still needs work for the next distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12302
diff changeset
199
24888
24f1d845cdb5 Merged the MacPython thanks list into the general acknowledgements.
Jack Jansen <jack.jansen@cwi.nl>
parents: 23245
diff changeset
200 As of Python 2.3 the MacPython thanks list has been merged into the
24f1d845cdb5 Merged the MacPython thanks list into the general acknowledgements.
Jack Jansen <jack.jansen@cwi.nl>
parents: 23245
diff changeset
201 general acknowledgements, see :Misc:ACKS.
12460
e5b31acb10ce Added a couple of contributors. Still needs work for the next distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12302
diff changeset
202
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
203 MacPython includes waste, a TextEdit replacement which is (c) 1998
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
204 Marco Piovanelli.
15190
656d434388c8 Updated for 2.0c1
Jack Jansen <jack.jansen@cwi.nl>
parents: 14822
diff changeset
205
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
206 A special mention is deserved by Matthias Neeracher, who has written
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
207 the brilliant unix-compatible GUSI I/O library, without which
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
208 MacPython would not have sockets or select, and to Alexandre
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
209 Parenteau, who has ported this library to Carbon.
16174
30c4c4e9e3d5 Added a note about the memory size.
Jack Jansen <jack.jansen@cwi.nl>
parents: 15407
diff changeset
210
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
211 Feedback
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
212 --------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
213
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
214 Send bug reports, suggestions, contributions and fanmail to
7030
05e0e499014f Release notes and readme for 1.5b3
Jack Jansen <jack.jansen@cwi.nl>
parents: 6463
diff changeset
215 <jack@cwi.nl>. However, a better way to discuss MacPython is to join the
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
216 <pythonmac-sig@python.org> mailing list, which is explicitly meant for
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
217 this purpose.
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
218
16984
f5cb6d66a977 Testing commit with a single blank line.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16817
diff changeset
219
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
220 Jack Jansen
21560
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
221 CWI
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
222 Kruislaan 413
ab92eaa140ef Merging changes from release22-branch.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21506
diff changeset
223 1098 SJ Amsterdam
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
224 the Netherlands
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
225
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
226 <jack@cwi.nl>, http://www.cwi.nl/~jack