Mercurial > cpython-lru_cache-weakref

annotate README @ 87690:66c1c9f32567 default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 3405dc9a6afa
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
87522
3405dc9a6afa Bump version number to 3.4.0b1.
Larry Hastings <larry@hastings.org>
parents: 87177
diff changeset
1 This is Python version 3.4.0 beta 1
3405dc9a6afa Bump version number to 3.4.0b1.
Larry Hastings <larry@hastings.org>
parents: 87177
diff changeset
2 ===================================
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
3
74212
879798e70473 add another year to glorious PSF IP
Benjamin Peterson <benjamin@python.org>
parents: 72262
diff changeset
4 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
83123
db093747ae06 Bump to 3.2.4rc1.
Georg Brandl <georg@python.org>
parents: 76235
diff changeset
5 2012, 2013 Python Software Foundation. All rights reserved.
43058
5b7aafadf223 Update Misc/NEWS. Add RELNOTES.
Guido van Rossum <guido@python.org>
parents: 43047
diff changeset
6
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
7 Python 3.x is a new version of the language, which is incompatible with the 2.x
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
8 line of releases. The language is mostly the same, but many details, especially
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
9 how built-in objects like dictionaries and strings work, have changed
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
10 considerably, and a lot of deprecated features have finally been removed.
39536
8f5b9982beba Completely get rid of PyClass and PyInstance.
Guido van Rossum <guido@python.org>
parents: 39442
diff changeset
11
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
12
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
13 Build Instructions
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
14 ------------------
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
15
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
16 On Unix, Linux, BSD, OSX, and Cygwin:
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
17
76919
1338b6fece2d Upgrade bzip2 to 1.0.6.
Martin v. Löwis <martin@v.loewis.de>
parents: 76689
diff changeset
18 New text
1338b6fece2d Upgrade bzip2 to 1.0.6.
Martin v. Löwis <martin@v.loewis.de>
parents: 76689
diff changeset
19
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
20 ./configure
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
21 make
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
22 make test
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
23 sudo make install
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
24
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
25 This will install Python as python3.
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
26
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
27 You can pass many options to the configure script; run "./configure --help" to
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
28 find out more. On OSX and Cygwin, the executable is called python.exe;
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
29 elsewhere it's just python.
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
30
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
31 On Mac OS X, if you have configured Python with --enable-framework, you should
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
32 use "make frameworkinstall" to do the installation. Note that this installs the
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
33 Python executable in a place that is not normally on your PATH, you may want to
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
34 set up a symlink in /usr/local/bin.
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
35
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
36 On Windows, see PCbuild/readme.txt.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
37
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
38 If you wish, you can create a subdirectory and invoke configure from there. For
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
39 example:
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
40
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
41 mkdir debug
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
42 cd debug
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
43 ../configure --with-pydebug
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
44 make
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
45 make test
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
46
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
47 (This will fail if you *also* built at the top-level directory. You should do a
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
48 "make clean" at the toplevel first.)
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
49
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
50
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
51 What's New
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
52 ----------
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
53
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
54 We try to have a comprehensive overview of the changes in the "What's New in
79240
1085b0e475d8 Bump version to 3.4.0 alpha 0.
Georg Brandl <georg@python.org>
parents: 79235
diff changeset
55 Python 3.4" document, found at
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
56
79240
1085b0e475d8 Bump version to 3.4.0 alpha 0.
Georg Brandl <georg@python.org>
parents: 79235
diff changeset
57 http://docs.python.org/3.4/whatsnew/3.4.html
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
58
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
59 For a more detailed change log, read Misc/NEWS (though this file, too, is
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
60 incomplete, and also doesn't list anything merged in from the 2.7 release under
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
61 development).
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
62
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
63 If you want to install multiple versions of Python see the section below
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
64 entitled "Installing multiple versions".
5591
da475e107a68 Minor edits for 1.5a2
Guido van Rossum <guido@python.org>
parents: 5525
diff changeset
65
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
66
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
67 Documentation
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
68 -------------
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
69
79240
1085b0e475d8 Bump version to 3.4.0 alpha 0.
Georg Brandl <georg@python.org>
parents: 79235
diff changeset
70 Documentation for Python 3.4 is online, updated daily:
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
71
79240
1085b0e475d8 Bump version to 3.4.0 alpha 0.
Georg Brandl <georg@python.org>
parents: 79235
diff changeset
72 http://docs.python.org/3.4/
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
73
63346
6b23aa300032 Bump versions and review NEWS file.
Georg Brandl <georg@python.org>
parents: 62412
diff changeset
74 It can also be downloaded in many formats for faster access. The documentation
6b23aa300032 Bump versions and review NEWS file.
Georg Brandl <georg@python.org>
parents: 62412
diff changeset
75 is downloadable in HTML, PDF, and reStructuredText formats; the latter version
6b23aa300032 Bump versions and review NEWS file.
Georg Brandl <georg@python.org>
parents: 62412
diff changeset
76 is primarily for documentation authors, translators, and people with special
6b23aa300032 Bump versions and review NEWS file.
Georg Brandl <georg@python.org>
parents: 62412
diff changeset
77 formatting requirements.
46222
aed698c8647b Merged revisions 62021,62029,62035-62038,62043-62044,62052-62053 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 45773
diff changeset
78
85196
477a143bfbfd #18707: point to Doc/README.txt in the README file. Patch by Madison May.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 83750
diff changeset
79 If you would like to contribute to the development of Python, relevant
477a143bfbfd #18707: point to Doc/README.txt in the README file. Patch by Madison May.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 83750
diff changeset
80 documentation is available at:
477a143bfbfd #18707: point to Doc/README.txt in the README file. Patch by Madison May.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 83750
diff changeset
81
477a143bfbfd #18707: point to Doc/README.txt in the README file. Patch by Madison May.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 83750
diff changeset
82 http://docs.python.org/devguide/
477a143bfbfd #18707: point to Doc/README.txt in the README file. Patch by Madison May.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 83750
diff changeset
83
477a143bfbfd #18707: point to Doc/README.txt in the README file. Patch by Madison May.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 83750
diff changeset
84 For information about building Python's documentation, refer to Doc/README.txt.
477a143bfbfd #18707: point to Doc/README.txt in the README file. Patch by Madison May.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 83750
diff changeset
85
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
86
49946
5235dcda9076 Prep for Python 3.1!
Barry Warsaw <barry@python.org>
parents: 49788
diff changeset
87 Converting From Python 2.x to 3.x
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
88 ---------------------------------
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
89
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
90 Python starting with 2.6 contains features to help locating code that needs to
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
91 be changed, such as optional warnings when deprecated features are used, and
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
92 backported versions of certain key Python 3.x features.
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
93
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
94 A source-to-source translation tool, "2to3", can take care of the mundane task
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
95 of converting large amounts of source code. It is not a complete solution but
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
96 is complemented by the deprecation warnings in 2.6. See
79240
1085b0e475d8 Bump version to 3.4.0 alpha 0.
Georg Brandl <georg@python.org>
parents: 79235
diff changeset
97 http://docs.python.org/3.4/library/2to3.html for more information.
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
98
45773
832c820e9d14 Merged revisions 61239-61249,61252-61257,61260-61264,61269-61275,61278-61279,61285-61286,61288-61290,61298,61303-61305,61312-61314,61317,61329,61332,61344,61350-61351,61363-61376,61378-61379,61382-61383,61387-61388,61392,61395-61396,61402-61403 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45622
diff changeset
99
51868
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
100 Testing
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
101 -------
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
102
72019
6c4fa9559b7e Update README section on testing following issue #11651.
Nadeem Vawda <nadeem.vawda@gmail.com>
parents: 71281
diff changeset
103 To test the interpreter, type "make test" in the top-level directory. The test
6c4fa9559b7e Update README section on testing following issue #11651.
Nadeem Vawda <nadeem.vawda@gmail.com>
parents: 71281
diff changeset
104 set produces some output. You can generally ignore the messages about skipped
6c4fa9559b7e Update README section on testing following issue #11651.
Nadeem Vawda <nadeem.vawda@gmail.com>
parents: 71281
diff changeset
105 tests due to optional features which can't be imported. If a message is printed
6c4fa9559b7e Update README section on testing following issue #11651.
Nadeem Vawda <nadeem.vawda@gmail.com>
parents: 71281
diff changeset
106 about a failed test or a traceback or core dump is produced, something is wrong.
51868
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
107
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
108 By default, tests are prevented from overusing resources like disk space and
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
109 memory. To enable these tests, run "make testall".
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
110
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
111 IMPORTANT: If the tests fail and you decide to mail a bug report, *don't*
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
112 include the output of "make test". It is useless. Run the failing test
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
113 manually, as follows:
51868
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
114
66906
d6ccbd3f5b45 Freshen README contents
Antoine Pitrou <solipsis@pitrou.net>
parents: 66729
diff changeset
115 ./python -m test -v test_whatever
51868
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
116
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
117 (substituting the top of the source tree for '.' if you built in a different
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
118 directory). This runs the test in verbose mode.
51868
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
119
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
120
45773
832c820e9d14 Merged revisions 61239-61249,61252-61257,61260-61264,61269-61275,61278-61279,61285-61286,61288-61290,61298,61303-61305,61312-61314,61317,61329,61332,61344,61350-61351,61363-61376,61378-61379,61382-61383,61387-61388,61392,61395-61396,61402-61403 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45622
diff changeset
121 Installing multiple versions
832c820e9d14 Merged revisions 61239-61249,61252-61257,61260-61264,61269-61275,61278-61279,61285-61286,61288-61290,61298,61303-61305,61312-61314,61317,61329,61332,61344,61350-61351,61363-61376,61378-61379,61382-61383,61387-61388,61392,61395-61396,61402-61403 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45622
diff changeset
122 ----------------------------
832c820e9d14 Merged revisions 61239-61249,61252-61257,61260-61264,61269-61275,61278-61279,61285-61286,61288-61290,61298,61303-61305,61312-61314,61317,61329,61332,61344,61350-61351,61363-61376,61378-61379,61382-61383,61387-61388,61392,61395-61396,61402-61403 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45622
diff changeset
123
832c820e9d14 Merged revisions 61239-61249,61252-61257,61260-61264,61269-61275,61278-61279,61285-61286,61288-61290,61298,61303-61305,61312-61314,61317,61329,61332,61344,61350-61351,61363-61376,61378-61379,61382-61383,61387-61388,61392,61395-61396,61402-61403 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45622
diff changeset
124 On Unix and Mac systems if you intend to install multiple versions of Python
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
125 using the same installation prefix (--prefix argument to the configure script)
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
126 you must take care that your primary python executable is not overwritten by the
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
127 installation of a different version. All files and directories installed using
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
128 "make altinstall" contain the major and minor version and can thus live
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
129 side-by-side. "make install" also creates ${prefix}/bin/python3 which refers to
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
130 ${prefix}/bin/pythonX.Y. If you intend to install multiple versions using the
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
131 same prefix you must decide which version (if any) is your "primary" version.
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
132 Install that version using "make install". Install all other versions using
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
133 "make altinstall".
45773
832c820e9d14 Merged revisions 61239-61249,61252-61257,61260-61264,61269-61275,61278-61279,61285-61286,61288-61290,61298,61303-61305,61312-61314,61317,61329,61332,61344,61350-61351,61363-61376,61378-61379,61382-61383,61387-61388,61392,61395-61396,61402-61403 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45622
diff changeset
134
79240
1085b0e475d8 Bump version to 3.4.0 alpha 0.
Georg Brandl <georg@python.org>
parents: 79235
diff changeset
135 For example, if you want to install Python 2.6, 2.7 and 3.4 with 2.7 being the
68071
0f52cfc91fae More automated version replacement.
Georg Brandl <georg@python.org>
parents: 68070
diff changeset
136 primary version, you would execute "make install" in your 2.7 build directory
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
137 and "make altinstall" in the others.
45773
832c820e9d14 Merged revisions 61239-61249,61252-61257,61260-61264,61269-61275,61278-61279,61285-61286,61288-61290,61298,61303-61305,61312-61314,61317,61329,61332,61344,61350-61351,61363-61376,61378-61379,61382-61383,61387-61388,61392,61395-61396,61402-61403 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45622
diff changeset
138
832c820e9d14 Merged revisions 61239-61249,61252-61257,61260-61264,61269-61275,61278-61279,61285-61286,61288-61290,61298,61303-61305,61312-61314,61317,61329,61332,61344,61350-61351,61363-61376,61378-61379,61382-61383,61387-61388,61392,61395-61396,61402-61403 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45622
diff changeset
139
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
140 Issue Tracker and Mailing List
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
141 ------------------------------
26240
e42997acc7f1 Explain what to do in case of missing shared libraries. Remove mentioning
Martin v. Löwis <martin@v.loewis.de>
parents: 26154
diff changeset
142
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
143 We're soliciting bug reports about all aspects of the language. Fixes are also
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
144 welcome, preferable in unified diff format. Please use the issue tracker:
35615
c6d7f1fe9d1e Update 64-bit AIX and HP-UX build instructions (forward port).
Guido van Rossum <guido@python.org>
parents: 35548
diff changeset
145
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
146 http://bugs.python.org/
6710
90c6390b4941 Add attributions to Jeffrey Ollie and Tim Peters for re.py; new QNX
Guido van Rossum <guido@python.org>
parents: 6680
diff changeset
147
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
148 If you're not sure whether you're dealing with a bug or a feature, use the
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
149 mailing list:
16390
d34f25046ad4 Added note about need for -traditional-cpp on the MacOS X Public Beta.
Fred Drake <fdrake@acm.org>
parents: 16288
diff changeset
150
51401
96fe45de7f26 Replace references to python-3000 mailing list with python-dev in
Mark Dickinson <dickinsm@gmail.com>
parents: 50533
diff changeset
151 python-dev@python.org
3922
e8bd430cd357 Final text for beta2 release. Hopefully no pre-1.4 information is left.
Guido van Rossum <guido@python.org>
parents: 3893
diff changeset
152
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
153 To subscribe to the list, use the mailman form:
27077
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
154
51401
96fe45de7f26 Replace references to python-3000 mailing list with python-dev in
Mark Dickinson <dickinsm@gmail.com>
parents: 50533
diff changeset
155 http://mail.python.org/mailman/listinfo/python-dev/
27077
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
156
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
157
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
158 Proposals for enhancement
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
159 -------------------------
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
160
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
161 If you have a proposal to change Python, you may want to send an email to the
67964
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
162 comp.lang.python or python-ideas mailing lists for inital feedback. A Python
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
163 Enhancement Proposal (PEP) may be submitted if your idea gains ground. All
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
164 current PEPs, as well as guidelines for submitting a new PEP, are listed at
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
165 http://www.python.org/dev/peps/.
43028
8077ee49fadf Forward Windows build instructions to PCbuild.
Martin v. Löwis <martin@v.loewis.de>
parents: 43009
diff changeset
166
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
167
54865
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
168 Release Schedule
a69a031ac140 rearrange the sections of the README, so they'll hopefully be more in the order people will interested in
Benjamin Peterson <benjamin@python.org>
parents: 54864
diff changeset
169 ----------------
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
170
85873
dd9cdf90a507 Version bump to 3.4.0a3.
Larry Hastings <larry@hastings.org>
parents: 85643
diff changeset
171 See PEP 429 for release details: http://www.python.org/dev/peps/pep-0429/
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
172
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
173
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
174 Copyright and License Information
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
175 ---------------------------------
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
176
83124
ca1c5a656bdd Copyright update to 2013.
Georg Brandl <georg@python.org>
parents: 83123
diff changeset
177 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
ca1c5a656bdd Copyright update to 2013.
Georg Brandl <georg@python.org>
parents: 83123
diff changeset
178 2012, 2013 Python Software Foundation. All rights reserved.
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
179
67964
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
180 Copyright (c) 2000 BeOpen.com. All rights reserved.
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
181
67964
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
182 Copyright (c) 1995-2001 Corporation for National Research Initiatives. All
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
183 rights reserved.
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
184
67964
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
185 Copyright (c) 1991-1995 Stichting Mathematisch Centrum. All rights reserved.
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
186
67964
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
187 See the file "LICENSE" for information on the history of this software, terms &
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
188 conditions for usage, and a DISCLAIMER OF ALL WARRANTIES.
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
189
67964
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
190 This Python distribution contains *no* GNU General Public License (GPL) code, so
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
191 it may be used in proprietary projects. There are interfaces to some GNU code
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
192 but these are entirely optional.
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
193
67964
496ac4d1a9ab Version bump to 3.2 final.
Georg Brandl <georg@python.org>
parents: 67937
diff changeset
194 All trademarks referenced herein are property of their respective holders.