annotate README @ 66807:d28126ebd60d

Entries for datetime, callable, and collections.Counter.
author Raymond Hettinger <python@rcn.com>
date Thu, 09 Dec 2010 16:41:54 +0000
parents 2f5cd1869b1a
children d6ccbd3f5b45
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
66729
2f5cd1869b1a Bump to 3.2b1.
Georg Brandl <georg@python.org>
parents: 66183
diff changeset
1 This is Python version 3.2 beta 1
2f5cd1869b1a Bump to 3.2b1.
Georg Brandl <georg@python.org>
parents: 66183
diff changeset
2 =================================
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
3
58061
c026b910a5e4 Merged revisions 77204 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 55090
diff changeset
4 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
45622
a31b650515cb Merged revisions 61143-61144,61146-61147,61150-61151,61157,61165-61168,61170-61173,61176-61177,61183 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45597
diff changeset
5 Python Software Foundation.
a31b650515cb Merged revisions 61143-61144,61146-61147,61150-61151,61157,61165-61168,61170-61173,61176-61177,61183 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45597
diff changeset
6 All rights reserved.
43058
5b7aafadf223 Update Misc/NEWS. Add RELNOTES.
Guido van Rossum <guido@python.org>
parents: 43047
diff changeset
7
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
8 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
9 line of releases. The language is mostly the same, but many details, especially
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
10 how built-in objects like dictionaries and strings work, have changed
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
11 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
12
34629
080d8cfed9d4 A few random updates to make things less horrifyingly out of date.
Michael W. Hudson <mwh@python.net>
parents: 34493
diff changeset
13
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
14 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
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
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 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
18
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
19 ./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
20 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
21 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
22 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
23
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 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
25
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
26 You can pass many options to the configure script; run "./configure --help" to
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
27 find out more. On OSX and Cygwin, the executable is called python.exe;
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
28 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
29
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
30 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
31 use "make frameworkinstall" to do the installation. Note that this installs the
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
32 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
33 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
34
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 On Windows, see PCbuild/readme.txt.
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
36
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
37 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
38 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
39
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 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
41 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
42 ../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
43 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
44 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
45
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
46 (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
47 "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
48
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 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
51 ----------
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 We try to have a comprehensive overview of the changes in the "What's New in
63346
6b23aa300032 Bump versions and review NEWS file.
Georg Brandl <georg@python.org>
parents: 62412
diff changeset
54 Python 3.2" 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
55
63599
cea6ed7a0aa1 #9457: fix documentation links for 3.2.
Georg Brandl <georg@python.org>
parents: 63363
diff changeset
56 http://docs.python.org/3.2/whatsnew/3.2.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
57
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
58 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
59 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
60 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
61
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 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
63 entitled "Installing multiple versions".
5591
da475e107a68 Minor edits for 1.5a2
Guido van Rossum <guido@python.org>
parents: 5525
diff changeset
64
4501
559aa47b2e2c Ready for release. Added section on the book. Removed bugs/gripes emails.
Guido van Rossum <guido@python.org>
parents: 4427
diff changeset
65
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
66 Documentation
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
67 -------------
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
68
63346
6b23aa300032 Bump versions and review NEWS file.
Georg Brandl <georg@python.org>
parents: 62412
diff changeset
69 Documentation for Python 3.2 is online, updated daily:
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
70
63599
cea6ed7a0aa1 #9457: fix documentation links for 3.2.
Georg Brandl <georg@python.org>
parents: 63363
diff changeset
71 http://docs.python.org/3.2/
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
72
63346
6b23aa300032 Bump versions and review NEWS file.
Georg Brandl <georg@python.org>
parents: 62412
diff changeset
73 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
74 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
75 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
76 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
77
14367
648a12a780d9 Ready to go.
Guido van Rossum <guido@python.org>
parents: 14249
diff changeset
78
49946
5235dcda9076 Prep for Python 3.1!
Barry Warsaw <barry@python.org>
parents: 49788
diff changeset
79 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
80 ---------------------------------
2658
3a3df231327c revamped README; the usual elsewhere...
Guido van Rossum <guido@python.org>
parents: 2510
diff changeset
81
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
82 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
83 be changed, such as optional warnings when deprecated features are used, and
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
84 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
85
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
86 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
87 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
88 is complemented by the deprecation warnings in 2.6. See
63599
cea6ed7a0aa1 #9457: fix documentation links for 3.2.
Georg Brandl <georg@python.org>
parents: 63363
diff changeset
89 http://docs.python.org/3.2/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
90
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
91
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
92 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
93 -------
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
94
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
95 To test the interpreter, type "make test" in the top-level directory. This runs
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
96 the test set twice (once with no compiled files, once with the compiled files
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
97 left by the previous test run). The test set produces some output. You can
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
98 generally ignore the messages about skipped tests due to optional features which
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
99 can't be imported. If a message is printed about a failed test or a traceback
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
100 or core dump is produced, something is wrong. On some Linux systems (those that
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
101 are not yet using glibc 6), test_strftime fails due to a non-standard
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
102 implementation of strftime() in the C library. Please ignore this, or upgrade to
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
103 glibc version 6.
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
104
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
105 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
106 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
107
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
108 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
109 include the output of "make test". It is useless. Run the failing test
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
110 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
111
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
112 ./python Lib/test/regrtest.py -v test_whatever
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
113
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
114 (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
115 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
116
e99b56da432a Merged revisions 69803-69805,69840,69901,69905,69907,69924,69927,69987 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 51401
diff changeset
117
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
118 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
119 ----------------------------
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
120
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 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
122 using the same installation prefix (--prefix argument to the configure script)
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
123 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
124 installation of a different version. All files and directories installed using
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
125 "make altinstall" contain the major and minor version and can thus live
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
126 side-by-side. "make install" also creates ${prefix}/bin/python3 which refers to
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
127 ${prefix}/bin/pythonX.Y. If you intend to install multiple versions using the
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
128 same prefix you must decide which version (if any) is your "primary" version.
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
129 Install that version using "make install". Install all other versions using
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
130 "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
131
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
132 For example, if you want to install Python 2.5, 2.6 and 3.2 with 2.6 being the
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
133 primary version, you would execute "make install" in your 2.6 build directory
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
134 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
135
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
136
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
137 Issue Tracker and Mailing List
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
138 ------------------------------
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
139
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
140 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
141 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
142
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
143 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
144
63363
43d14bbd6eb1 Rewrap.
Georg Brandl <georg@python.org>
parents: 63346
diff changeset
145 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
146 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
147
51401
96fe45de7f26 Replace references to python-3000 mailing list with python-dev in
Mark Dickinson <dickinsm@gmail.com>
parents: 50533
diff changeset
148 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
149
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
150 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
151
51401
96fe45de7f26 Replace references to python-3000 mailing list with python-dev in
Mark Dickinson <dickinsm@gmail.com>
parents: 50533
diff changeset
152 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
153
c1f4e53c42dd Merged Misc/AtheOS-NOTES into the platform-specific section. Rewrote the
Skip Montanaro <skip@pobox.com>
parents: 27053
diff changeset
154
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
155 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
156 -------------------------
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
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 If you have a proposal to change Python, you may want to send an email to the
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 comp.lang.python or python-ideas mailing lists for inital feedback. A Python
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
160 Enhancement Proposal (PEP) may be submitted if your idea gains ground. All
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 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
162 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
163
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
164
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
165 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
166 ----------------
43009
07d67a9725a7 Mostly rewritten, much shorter README for Py3k.
Guido van Rossum <guido@python.org>
parents: 42645
diff changeset
167
62411
6d9746cd935c update release schedule url
Benjamin Peterson <benjamin@python.org>
parents: 58061
diff changeset
168 See PEP 392 for release details: http://www.python.org/dev/peps/pep-0392/
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
169
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
170
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
171 Copyright and License Information
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
62412
654e53e75cd2 add copyright years
Benjamin Peterson <benjamin@python.org>
parents: 62411
diff changeset
174 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
43047
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
175 Python Software Foundation.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
176 All rights reserved.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
177
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
178 Copyright (c) 2000 BeOpen.com.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
179 All rights reserved.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
180
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
181 Copyright (c) 1995-2001 Corporation for National Research Initiatives.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
182 All rights reserved.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
183
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
184 Copyright (c) 1991-1995 Stichting Mathematisch Centrum.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
185 All rights reserved.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
186
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
187 See the file "LICENSE" for information on the history of this
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
188 software, terms & conditions for usage, and a DISCLAIMER OF ALL
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
189 WARRANTIES.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
190
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
191 This Python distribution contains *no* GNU General Public License
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
192 (GPL) code, so it may be used in proprietary projects. There are
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
193 interfaces to some GNU code but these are entirely optional.
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
194
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
195 All trademarks referenced herein are property of their respective
08f7a6b25c8f Move the copyright and license stuff to the end.
Guido van Rossum <guido@python.org>
parents: 43028
diff changeset
196 holders.