annotate Mac/ReadMe @ 25838:8540887bcec6 2.2

Backport of 2.183: Fix memory leak in add_subclass() found by NealN with valgrind.
author Guido van Rossum <guido@python.org>
date Fri, 18 Oct 2002 13:42:21 +0000
parents b1fa90f8b6c2
children 808e513a2f5c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
22158
b1d573a2a774 First stab at files for 2.2.1.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21563
diff changeset
1 How to install Python 2.2.1 on your Macintosh
18962
d7590122f9a2 Merging appropriate 2.1.1 fixes back into the main trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17758
diff changeset
2 ---------------------------------------------
16649
8d8509617874 2.1a2 distribution files.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16174
diff changeset
3
17633
7f5e3e6b2a39 Files for 2.1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17237
diff changeset
4 This is a MacPython that can run on classic MacOS (from 8.1
17001
2dc3ca1d890c Files for 2.1b1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16984
diff changeset
5 onwards) and natively on MacOSX. The installer tries to work out whether you can
21506
d6a44fd1f4c1 Applying r22c1 branch mods back to the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21384
diff changeset
6 use the Carbon version or not. For Mac OS X users: this version of Python
d6a44fd1f4c1 Applying r22c1 branch mods back to the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21384
diff changeset
7 does not run from the command line, it is a pure "Mac only" app. Use the standard
d6a44fd1f4c1 Applying r22c1 branch mods back to the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21384
diff changeset
8 unix Python from the commandline, the two Pythons will be merged in the future.
16649
8d8509617874 2.1a2 distribution files.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16174
diff changeset
9
19569
cea7fea1742b Started on release notes and readme for 2.2a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 19500
diff changeset
10 You should definitely read the Relnotes file too, and the section below about
20638
6f2cb18068dd Tweaks for MacPython 2.2b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 19811
diff changeset
11 toolbox module reorganization. You should also read :Misc:NEWS, which lists
6f2cb18068dd Tweaks for MacPython 2.2b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 19811
diff changeset
12 the general (non-mac-dependent) new features of this Python release.
16649
8d8509617874 2.1a2 distribution files.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16174
diff changeset
13
17633
7f5e3e6b2a39 Files for 2.1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17237
diff changeset
14 A special note about the active installer: do not background it, it may hang
17237
390a8315d634 Updated for 2.1b2 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17045
diff changeset
15 your machine. This is a general problem with Vise active installers, MindVision
390a8315d634 Updated for 2.1b2 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17045
diff changeset
16 are working on it.
17045
ff75c382f0d3 Files for second 2.1b1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17001
diff changeset
17
16649
8d8509617874 2.1a2 distribution files.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16174
diff changeset
18 ------
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
19
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
20 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
21 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
22 (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
23 ftp.python.org. Through there, or via
11676ddaff01 Ready for 2.0
Jack Jansen <jack.jansen@cwi.nl>
parents: 15190
diff changeset
24 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
25 MacPython distribution.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
26
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
27 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
28 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
29 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
30
17001
2dc3ca1d890c Files for 2.1b1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16984
diff changeset
31 This installer installs MacPython for classic PPC MacOS, MacPython for Carbon
21563
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
32 (OS X, OS 9 or OS 8 with CarbonLib installed) or both, depending on your
17001
2dc3ca1d890c Files for 2.1b1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16984
diff changeset
33 configuration. By selecting custom install you can bypass these tests and
2dc3ca1d890c Files for 2.1b1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16984
diff changeset
34 install what you want.
7030
05e0e499014f Release notes and readme for 1.5b3
Jack Jansen <jack.jansen@cwi.nl>
parents: 6463
diff changeset
35
21563
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
36 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
37
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
38 What to install
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
39 ---------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
40
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
41 The optional parts in this distribution are
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
42 - TK+PIL: Tkinter and support modules, plus Imaging, the Python image
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
43 manipulation package (allows you to read, write and display images and
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
44 do lots of operations on them).
17001
2dc3ca1d890c Files for 2.1b1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16984
diff changeset
45 For Carbon MacPython you only get PIL: there is no Tcl/Tk for Carbon yet.
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
46 This is the reason Classic MacPython is also installed on MacOSX: it
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
47 allows you to run Tkinter applications, albeit in the Classic box.
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
48 - 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
49 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
50 between the packages.
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
51 - Numeric: the LLNL Numeric Python extension. All sorts of nifty operations
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
52 on matrices and such. This is the most recent version from the
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
53 sourceforge archive.
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
54 Numeric has moved from Extensions to :Lib:site-python, by the way,
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
55 see the release notes.
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
56 - 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
57 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
58 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
59
17001
2dc3ca1d890c Files for 2.1b1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16984
diff changeset
60 After the installer finishes it automatically launches the appropriate
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
61 ConfigurePython applet, to finish configuration of your Python. If you
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
62 run MacOS9 or later (or 8 with CarbonLib installed) you can switch
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
63 back and forth between the classic and Carbon versions of Python by
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
64 running either ConfigurePythonClassic or ConfigurePythonCarbon.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
65
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
66 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
67 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
68 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
69 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
70
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
71 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
72 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
73 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
74 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
75 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
76
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
77 After installing
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
78 ----------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
79
14501
58ba90e4e985 Updated for 2.0b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 13639
diff changeset
80 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
81 Python and "import test.regrtest ; test.regrtest.main()".
15190
656d434388c8 Updated for 2.0c1
Jack Jansen <jack.jansen@cwi.nl>
parents: 14822
diff changeset
82
21113
ed3dce17fc79 Merged changes made on r22b2-branch between r22b2 and r22b2-mac (the
Jack Jansen <jack.jansen@cwi.nl>
parents: 20785
diff changeset
83 test_frozen will fail in MacPython because of different handling on
ed3dce17fc79 Merged changes made on r22b2-branch between r22b2 and r22b2-mac (the
Jack Jansen <jack.jansen@cwi.nl>
parents: 20785
diff changeset
84 frozen modules. This should not be a problem in normal use.
ed3dce17fc79 Merged changes made on r22b2-branch between r22b2 and r22b2-mac (the
Jack Jansen <jack.jansen@cwi.nl>
parents: 20785
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 test_time will fail because MacPython accepts bogus values for
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
87 mktime(), this will be fixed later (it is not a very serious problem).
19811
38c12faf612a Final tweaks for 2.2a3 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 19569
diff changeset
88
22869
b1fa90f8b6c2 Files used for 2.2.1 release (unless disaster strikes in the next 24 hours).
Jack Jansen <jack.jansen@cwi.nl>
parents: 22546
diff changeset
89 test_email will fail during summer (no kidding:-). Actually, it will fail
b1fa90f8b6c2 Files used for 2.2.1 release (unless disaster strikes in the next 24 hours).
Jack Jansen <jack.jansen@cwi.nl>
parents: 22546
diff changeset
90 when DST is active, because the date parsing test is GMT-centric
b1fa90f8b6c2 Files used for 2.2.1 release (unless disaster strikes in the next 24 hours).
Jack Jansen <jack.jansen@cwi.nl>
parents: 22546
diff changeset
91 and does not handle the Macintosh's localtime very well.
b1fa90f8b6c2 Files used for 2.2.1 release (unless disaster strikes in the next 24 hours).
Jack Jansen <jack.jansen@cwi.nl>
parents: 22546
diff changeset
92
19811
38c12faf612a Final tweaks for 2.2a3 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 19569
diff changeset
93 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
94 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
95
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
96 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
97 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
98 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
99 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
100 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
101 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
102 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
103 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
104 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
105
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
106 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
107 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
108 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
109 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
110
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
111 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
112 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
113 ways.
14501
58ba90e4e985 Updated for 2.0b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 13639
diff changeset
114
22546
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
115 OSX Multiple users note
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
116 -----------------------
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
117
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
118 Interaction with Mac OS X multiple users has been tested only very lightly.
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
119 If you install as a privileged user everything installs fine.
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
120
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
121 If you install as a non-privileged user everything should install in your local
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
122 per-user folders. But: as there is no global PythonCore you can only run applets
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
123 if they reside in your toplevel Python folder.
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
124
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
125 If you install as a privileged user and then try to run
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
126 Python as another (non-privileged) user you may encounter a problem with
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
127 not having a preference file: the symptom is failing to import all sorts
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
128 of standard modules. If you remove your per-user Python preference files
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
129 (in ~/Library/Preferences) and then run PythonIntpreter once everything should
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
130 be fine.
6b3e99b2ff91 Added a note about preference file problems for non-privileged OSX
Jack Jansen <jack.jansen@cwi.nl>
parents: 22158
diff changeset
131
6463
0b2bcf0424a0 Updated for 1.5a4
Jack Jansen <jack.jansen@cwi.nl>
parents: 6163
diff changeset
132 Uninstalling
0b2bcf0424a0 Updated for 1.5a4
Jack Jansen <jack.jansen@cwi.nl>
parents: 6163
diff changeset
133 ------------
0b2bcf0424a0 Updated for 1.5a4
Jack Jansen <jack.jansen@cwi.nl>
parents: 6163
diff changeset
134
21563
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
135 Up to three items are installed in the system folder: the interpreter shared
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
136 libraries PythonCore and PythonCoreCarbon live in the Extensions
22158
b1d573a2a774 First stab at files for 2.2.1.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21563
diff changeset
137 folder and the "Python 2.2.1 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
138 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
139 you installed in.
6463
0b2bcf0424a0 Updated for 1.5a4
Jack Jansen <jack.jansen@cwi.nl>
parents: 6163
diff changeset
140
21563
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
141 On OSX the libraries are installed in /Library/CFMSupport. The ConfigurePython
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
142 applets will complain if you have no right to create the libraries there
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
143 (you need Admin privileges). This has one consequence: you will not be able to
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
144 run applets unless they reside in the MacPython folder (such as the IDE or
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
145 EditPythonPrefs). If you try to run an applet stored elsewhere you will
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
146 get a "Cannot locate PythonCore" error message.
17633
7f5e3e6b2a39 Files for 2.1 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 17237
diff changeset
147
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
148 Things to see
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
149 -------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
150
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
151 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
152
14501
58ba90e4e985 Updated for 2.0b1
Jack Jansen <jack.jansen@cwi.nl>
parents: 13639
diff changeset
153 There are also some interesting files in the "Relnotes" folder that may
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
154 contain useful information. There is also a first stab at documentation
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
155 (plus examples) in the Mac:Demo folder. The toplevel Demo folder has
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
156 machine-independent demos.
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
157 The Mac:Lib:test folder also has some programs that show simple
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
158 capabilities of various modules.
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
159
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
160 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
161 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
162 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
163 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
164 various other toolboxes from python.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
165
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
166 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
167 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
168
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
169 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
170 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
171 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
172
b1b26e0e0a0a Updated for 1.5.1
Jack Jansen <jack.jansen@cwi.nl>
parents: 7426
diff changeset
173 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
174 software.
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
175
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
176 Upgrading from older Python releases
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
177 ------------------------------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
178
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
179 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
180 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
181 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
182 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
183 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
184
22158
b1d573a2a774 First stab at files for 2.2.1.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21563
diff changeset
185 After you are satisfied that 2.2.1 works as expected you can trash
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
186 anything in the system folder that has "python" in the name and not
22158
b1d573a2a774 First stab at files for 2.2.1.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21563
diff changeset
187 "2.2.1".
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
188
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
189 The ConfigurePython... applets will try to detect incompatible
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
190 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
191 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
192 (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
193
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
194 The installer
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
195 -------------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
196
12599
6455d8fb7876 Updated for 1.6a2.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12460
diff changeset
197 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
198 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
199 contact:
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
200 MindVision Software
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
201 7201 North 7th Street
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
202 Lincoln, NE 68521-8913
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
203 Voice: 402-477-3269
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
204 Fax: 402-477-1395
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
205 Internet: mindvision@mindvision.com
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
206 http://www.mindvision.com
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
207
21384
c44c911606a4 fixed typo in my email address
Just van Rossum <just@letterror.com>
parents: 21113
diff changeset
208 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
209 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
210
12460
e5b31acb10ce Added a couple of contributors. Still needs work for the next distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12302
diff changeset
211 Thanks!
e5b31acb10ce Added a couple of contributors. Still needs work for the next distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12302
diff changeset
212 -------
e5b31acb10ce Added a couple of contributors. Still needs work for the next distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12302
diff changeset
213
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
214 Thanks go to the whole Python community with Guido in the lead, of
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
215 course. Mac-specific thanks go to the pythonmac-sig, Just van Rossum,
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
216 Corran Webster, Tony Ingraldi, Erik van Blokland, Bill Bedford, Chris
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
217 Stern, Gordon Worley, Oliver Steele, M. Papillon, Steven Majewski, David
15278
11676ddaff01 Ready for 2.0
Jack Jansen <jack.jansen@cwi.nl>
parents: 15190
diff changeset
218 Goodger, Chris Barker, Luc Lefebvre, Tattoo Mabonzo K., Russell Finn,
19811
38c12faf612a Final tweaks for 2.2a3 distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 19569
diff changeset
219 Tom Bridgman, Russel Owen, Pascal Oberndoerfer, Dean Draayer,
21506
d6a44fd1f4c1 Applying r22c1 branch mods back to the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21384
diff changeset
220 Alexandre Parenteau, Donovan Preston, Daniel Brotsky, Jason Harper,
d6a44fd1f4c1 Applying r22c1 branch mods back to the trunk.
Jack Jansen <jack.jansen@cwi.nl>
parents: 21384
diff changeset
221 Nitin Ganatra,
19500
d0ce0460f4a7 Added Dean Draayer to the thank you list.
Jack Jansen <jack.jansen@cwi.nl>
parents: 18962
diff changeset
222 and all the other people who provided feedback, code or both!
12460
e5b31acb10ce Added a couple of contributors. Still needs work for the next distribution.
Jack Jansen <jack.jansen@cwi.nl>
parents: 12302
diff changeset
223
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
224 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
225 Marco Piovanelli.
15190
656d434388c8 Updated for 2.0c1
Jack Jansen <jack.jansen@cwi.nl>
parents: 14822
diff changeset
226
20785
4df6527b7882 Added Donovan Preston and reformatted to 80-char lines.
Jack Jansen <jack.jansen@cwi.nl>
parents: 20638
diff changeset
227 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
228 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
229 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
230 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
231
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
232 Feedback
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
233 --------
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
234
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
235 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
236 <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
237 <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
238 this purpose.
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
239
16984
f5cb6d66a977 Testing commit with a single blank line.
Jack Jansen <jack.jansen@cwi.nl>
parents: 16817
diff changeset
240
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
241 Jack Jansen
21563
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
242 CWI
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
243 Kruislaan 413
fcb649b1004d This commit was manufactured by cvs2svn to create branch
cvs2svn <tools@python.org>
parents: 21506
diff changeset
244 1098 SJ Amsterdam
6163
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
245 the Netherlands
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
246
119d184bb5ed Adapted from ReadMeOrSuffer for the new installer
Jack Jansen <jack.jansen@cwi.nl>
parents:
diff changeset
247 <jack@cwi.nl>, http://www.cwi.nl/~jack