annotate Mac/BuildScript/resources/ReadMe.txt @ 87690:66c1c9f32567 default tip

Add use_weakref option to functools.lru_cache The use_weakref option makes lru_cache create weak references to the function arguments when creating the cache key, which prevents them from staying in the memory forever even after all other references to them are gone. This is a proof of concept for http://bugs.python.org/issue19859
author Radomir Dopieralski <devel@sheep.art.pl>
date Tue, 03 Dec 2013 16:02:48 +0100
parents 4990fa0baa8b
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
54212
c7fd741c72eb Merged revisions 72789 via svnmerge from
Ronald Oussoren <ronaldoussoren@mac.com>
parents: 52471
diff changeset
1 This package will install Python $FULL_VERSION for Mac OS X
67595
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
2 $MACOSX_DEPLOYMENT_TARGET for the following architecture(s):
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
3 $ARCHITECTURES.
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
4
86616
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
5 **** IMPORTANT ****
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
6
86616
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
7 Installing on OS X 10.8 (Mountain Lion) or later systems
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
8 ========================================================
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
9
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
10 If you are attempting to install on an OS X 10.8+ system, you may
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
11 see a message that Python can't be installed because it is from an
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
12 unidentified developer. This is because this Python installer
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
13 package is not yet compatible with the Gatekeeper security feature
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
14 introduced in OS X 10.8. To allow Python to be installed, you
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
15 can override the Gatekeeper policy for this install. In the Finder,
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
16 instead of double-clicking, control-click or right click the "Python"
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
17 installer package icon. Then select "Open using ... Installer" from
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
18 the contextual menu that appears.
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
19
87399
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
20 **** IMPORTANT ****
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
21
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
22 Update your version of Tcl/Tk to use IDLE or other Tk applications
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
23 ==================================================================
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
24
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
25 To use IDLE or other programs that use the Tkinter graphical user
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
26 interface toolkit, you may need to install a newer third-party version
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
27 of the Tcl/Tk frameworks. Visit http://www.python.org/download/mac/tcltk/
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
28 for current information about supported and recommended versions of
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
29 Tcl/Tk for this version of Python and of Mac OS X.
d666e8ee687d Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
Ned Deily <nad@acm.org>
parents: 87393
diff changeset
30
87393
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
31 **NEW* As of Python 3.4.0b1:
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
32
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
33 New Installation Options and Defaults
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
34 =====================================
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
35
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
36 The Python installer now includes an option to automatically install
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
37 or upgrade pip, a tool for installing and managing Python packages.
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
38 This option is enabled by default and no Internet access is required.
87482
4990fa0baa8b Fix typo in and reformat OS X Installer ReadMe
Ned Deily <nad@acm.org>
parents: 87399
diff changeset
39 If you do not want the installer to do this, select the "Customize"
4990fa0baa8b Fix typo in and reformat OS X Installer ReadMe
Ned Deily <nad@acm.org>
parents: 87399
diff changeset
40 option at the "Installation Type" step and uncheck the "Install or
4990fa0baa8b Fix typo in and reformat OS X Installer ReadMe
Ned Deily <nad@acm.org>
parents: 87399
diff changeset
41 ugprade pip" option.
87393
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
42
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
43 To make it easier to use scripts installed by third-party Python
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
44 packages, with pip or by other means, the "Shell profile updater"
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
45 option is now enabled by default, as has been the case with Python
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
46 2.7.x installers. You can also turn this option off by selecting
87482
4990fa0baa8b Fix typo in and reformat OS X Installer ReadMe
Ned Deily <nad@acm.org>
parents: 87399
diff changeset
47 "Customize" and unchecking the "Shell profile updater" option. You
4990fa0baa8b Fix typo in and reformat OS X Installer ReadMe
Ned Deily <nad@acm.org>
parents: 87399
diff changeset
48 can also update your shell profile later by launching the "Update
4990fa0baa8b Fix typo in and reformat OS X Installer ReadMe
Ned Deily <nad@acm.org>
parents: 87399
diff changeset
49 Shell Profile" command found in the /Applications/Python $VERSION
4990fa0baa8b Fix typo in and reformat OS X Installer ReadMe
Ned Deily <nad@acm.org>
parents: 87399
diff changeset
50 folder. You may need to start a new terminal window for the
4990fa0baa8b Fix typo in and reformat OS X Installer ReadMe
Ned Deily <nad@acm.org>
parents: 87399
diff changeset
51 changes to take effect.
87393
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
52
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
53 Python.org Python $VERSION and 2.7.x versions can both be installed and
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
54 will not conflict. Command names for Python 3 contain a 3 in them,
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
55 python3 (or python$VERSION), idle3 (or idle$VERSION), pip3 (or pip$VERSION), etc.
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
56 Python 2.7 command names contain a 2 or no digit: python2 (or
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
57 python2.7 or python), idle2 (or idle2.7 or idle), etc. If you want to
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
58 use pip with Python 2.7.x, you will need to download and install a
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
59 separate copy of it from the Python Package Index
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
60 (https://pypi.python.org/pypi).
4e12f145f18f Issue #19551: PEP 453 - OS X installer now installs or upgrades pip by default.
Ned Deily <nad@acm.org>
parents: 86940
diff changeset
61
86616
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
62 Using this version of Python on OS X
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
63 ====================================
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
64
67595
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
65 Python consists of the Python programming language interpreter, plus
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
66 a set of programs to allow easy access to it for Mac users including
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
67 an integrated development environment, IDLE, plus a set of pre-built
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
68 extension modules that open up specific Macintosh technologies to
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
69 Python programs.
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
70
67595
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
71 The installer puts applications, an "Update Shell Profile" command,
67900
7c71b0a5a290 Issue #11079: The /Applications/Python x.x folder created by the Mac
Ned Deily <nad@acm.org>
parents: 67595
diff changeset
72 and a link to the optionally installed Python Documentation into the
67595
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
73 "Python $VERSION" subfolder of the system Applications folder,
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
74 and puts the underlying machinery into the folder
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
75 $PYTHONFRAMEWORKINSTALLDIR. It can
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
76 optionally place links to the command-line tools in /usr/local/bin as
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
77 well. Double-click on the "Update Shell Profile" command to add the
18ab8e0e6702 #10907: Warn OS X 10.6 IDLE users to use ActiveState Tcl/Tk 8.5,
Ned Deily <nad@acm.org>
parents: 54212
diff changeset
78 "bin" directory inside the framework to your shell's search path.
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
79
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
80 You must install onto your current boot disk, even though the
86616
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
81 installer may not enforce this, otherwise things will not work.
78759
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
82
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
83 You can verify the integrity of the disk image file containing the
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
84 installer package and this ReadMe file by comparing its md5 checksum
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
85 and size with the values published on the release page linked at
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
86 http://www.python.org/download/
6c898f297925 Update various OS X README files for 3.3.0.
Ned Deily <nad@acm.org>
parents: 67900
diff changeset
87
86616
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
88 Installation requires approximately $INSTALL_SIZE MB of disk space,
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
89 ignore the message that it will take zero bytes.
5ff4f0100a40 Issue #15663: Tcl/Tk 8.5.15 is now included with the OS X 10.6+
Ned Deily <nad@acm.org>
parents: 78759
diff changeset
90
51558
08cc574af4f6 Merged revisions 69538 via svnmerge from
Ronald Oussoren <ronaldoussoren@mac.com>
parents: 46664
diff changeset
91 More information on Python in general can be found at
38673
a19c20c5e5c7 Merge the rest of the trunk.
Thomas Wouters <thomas@python.org>
parents:
diff changeset
92 http://www.python.org.