Browse Source

Updated install docs to reflect Python 3 status.

Closes #17452.
Aymeric Augustin 12 years ago
parent
commit
7435cc0167
3 changed files with 22 additions and 32 deletions
  1. 17 23
      docs/faq/install.txt
  2. 3 5
      docs/intro/install.txt
  3. 2 4
      docs/topics/install.txt

+ 17 - 23
docs/faq/install.txt

@@ -16,8 +16,9 @@ How do I get started?
 What are Django's prerequisites?
 --------------------------------
 
-Django requires Python_, specifically Python 2.6.5 - 2.7.x.  No other Python
-libraries are required for basic Django usage.
+Django requires Python, specifically Python 2.6.5 - 2.7.x. No other Python
+libraries are required for basic Django usage. Django 1.5 also has
+experimental support for Python 3.2 and above.
 
 For a development environment -- if you just want to experiment with Django --
 you don't need to have a separate Web server installed; Django comes with its
@@ -50,15 +51,12 @@ aren't available under older versions of Python.
 Third-party applications for use with Django are, of course, free to set their
 own version requirements.
 
-Over the next year or two Django will begin dropping support for older Python
-versions as part of a migration which will end with Django running on Python 3
-(see below for details).
-
 All else being equal, we recommend that you use the latest 2.x release
 (currently Python 2.7). This will let you take advantage of the numerous
-improvements and optimizations to the Python language since version 2.6, and
-will help ease the process of dropping support for older Python versions on
-the road to Python 3.
+improvements and optimizations to the Python language since version 2.6.
+
+Generally speaking, we don't recommend running Django on Python 3 yet; see
+below for more.
 
 What Python version can I use with Django?
 ------------------------------------------
@@ -71,25 +69,21 @@ Django version Python versions
 1.2            2.4, 2.5, 2.6, 2.7
 1.3            2.4, 2.5, 2.6, 2.7
 **1.4**        **2.5, 2.6, 2.7**
-*1.5 (future)* *2.6, 2.7, 3.x (experimental)*
+*1.5 (future)* *2.6, 2.7* and *3.2, 3.3 (experimental)*
 ============== ===============
 
 Can I use Django with Python 3?
 -------------------------------
 
-Not at the moment. Python 3.0 introduced a number of
-backwards-incompatible changes to the Python language, and although
-these changes are generally a good thing for Python's future, it will
-be a while before most Python software catches up and is able to run
-on Python 3.0. For larger Python-based software like Django, the
-transition is expected to take at least a year or two (since it
-involves dropping support for older Python releases and so must be
-done gradually).
-
-In the meantime, Python 2.x releases will be supported and provided
-with bug fixes and security updates by the Python development team, so
-continuing to use a Python 2.x release during the transition should
-not present any risk.
+Django 1.5 introduces experimental support for Python 3.2 and 3.3. However, we
+don't yet suggest that you use Django and Python 3 in production.
+
+Python 3 support should be considered a "preview". It's offered to bootstrap
+the transition of the Django ecosystem to Python 3, and to help you start
+porting your apps for future Python 3 compatibility. But we're not yet
+confidant enough to promise stability in production.
+
+Our current plan is to make Django 1.6 suitable for general use with Python 3.
 
 Will Django run under shared hosting (like TextDrive or Dreamhost)?
 -------------------------------------------------------------------

+ 3 - 5
docs/intro/install.txt

@@ -10,11 +10,9 @@ Install Python
 --------------
 
 Being a Python Web framework, Django requires Python. It works with any Python
-version from 2.6.5 to 2.7 (due to backwards incompatibilities in Python 3.0,
-Django does not currently work with Python 3.0; see :doc:`the Django FAQ
-</faq/install>` for more information on supported Python versions and the 3.0
-transition), these versions of Python include a lightweight database called
-SQLite_ so you won't need to set up a database just yet.
+version from 2.6.5 to 2.7. It also features experimental support for versions
+3.2 and 3.3. All these versions of Python include a lightweight database
+called SQLite_ so you won't need to set up a database just yet.
 
 .. _sqlite: http://sqlite.org/
 

+ 2 - 4
docs/topics/install.txt

@@ -9,10 +9,8 @@ Install Python
 
 Being a Python Web framework, Django requires Python.
 
-It works with any Python version from 2.6.5 to 2.7 (due to backwards
-incompatibilities in Python 3.0, Django does not currently work with
-Python 3.0; see :doc:`the Django FAQ </faq/install>` for more
-information on supported Python versions and the 3.0 transition).
+It works with any Python version from 2.6.5 to 2.7. It also features
+experimental support for versions 3.2 and 3.3.
 
 Get Python at http://www.python.org. If you're running Linux or Mac OS X, you
 probably already have it installed.