django/docs/releases/index.txt

=============
Release notes
=============

Release notes for the official Django releases. Each release note will tell you
what's new in each version, and will also describe any backwards-incompatible
changes made in that version.

For those :doc:`upgrading to a new version of Django</howto/upgrade-version>`,
you will need to check all the backwards-incompatible changes and
:doc:`deprecated features</internals/deprecation>` for each 'final' release
from the one after your current Django version, up to and including the new
version.

Final releases
==============

.. _development_release_notes:

1.7 release
-----------
.. toctree::
   :maxdepth: 1

   1.7

1.6 release
-----------
.. toctree::
   :maxdepth: 1

   1.6.2
   1.6.1
   1.6

1.5 release
-----------
.. toctree::
   :maxdepth: 1

   1.5.5
   1.5.4
   1.5.3
   1.5.2
   1.5.1
   1.5

1.4 release
-----------
.. toctree::
   :maxdepth: 1

   1.4.10
   1.4.9
   1.4.8
   1.4.7
   1.4.6
   1.4.5
   1.4.4
   1.4.3
   1.4.2
   1.4.1
   1.4

1.3 release
-----------
.. toctree::
   :maxdepth: 1

   1.3.7
   1.3.6
   1.3.5
   1.3.4
   1.3.3
   1.3.2
   1.3.1
   1.3

1.2 release
-----------
.. toctree::
   :maxdepth: 1

   1.2.7
   1.2.6
   1.2.5
   1.2.4
   1.2.3
   1.2.2
   1.2.1
   1.2

1.1 release
-----------
.. toctree::
   :maxdepth: 1

   1.1.4
   1.1.3
   1.1.2
   1.1

1.0 release
-----------
.. toctree::
   :maxdepth: 1

   1.0.2
   1.0.1
   1.0

Pre-1.0 releases
----------------
.. toctree::
   :maxdepth: 1

   0.96
   0.95

Security releases
=================

Whenever a security issue is disclosed via :doc:`Django's security
policies </internals/security>`, appropriate release notes are now
added to all affected release series.

Additionally, :doc:`an archive of disclosed security issues
</releases/security>` is maintained.

Development releases
====================

These notes are retained for historical purposes. If you are upgrading
between formal Django releases, you don't need to worry about these
notes.

.. toctree::
   :maxdepth: 1

   security
   1.5-beta-1
   1.5-alpha-1
   1.4-beta-1
   1.4-alpha-1
   1.3-beta-1
   1.3-alpha-1
   1.2-rc-1
   1.2-beta-1
   1.2-alpha-1
   1.1-rc-1
   1.1-beta-1
   1.1-alpha-1
   1.0-beta-2
   1.0-beta
   1.0-alpha-2
   1.0-alpha-1
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`=============`
Massive reorganization of the docs. See the new docs online at http://docs.djangoproject.com/. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8506 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2008-08-24 06:25:40 +08:00			`Release notes`
			`=============`

Fixed #11519 -- Corrected minor typo in release notes index. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11338 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-07-27 09:52:23 +08:00			`Release notes for the official Django releases. Each release note will tell you`
Massive reorganization of the docs. See the new docs online at http://docs.djangoproject.com/. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8506 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2008-08-24 06:25:40 +08:00			`what's new in each version, and will also describe any backwards-incompatible`
			`changes made in that version.`

Fixed #17048 - Added docs for upgrading Django. Thanks Donald Stufft for the suggestion and Susan Tan and Brian Fabian Crain for the patch. 2013-05-22 19:57:36 +08:00			For those :doc:`upgrading to a new version of Django</howto/upgrade-version>`,
			`you will need to check all the backwards-incompatible changes and`
			:doc:`deprecated features</internals/deprecation>` for each 'final' release
			`from the one after your current Django version, up to and including the new`
			`version.`
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00
			`Final releases`
			`==============`

Replaced backwards-incompatible changes reference The previously-referenced wiki page documents backwards-incompatible changes from .96 to 1.0. Changed that referece to point to current in-development release notes, which is where such changes are now documented. 2012-09-10 00:53:32 +08:00			`.. _development_release_notes:`
Added stub release notes for 1.4 git-svn-id: http://code.djangoproject.com/svn/django/trunk@15947 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-03-31 01:34:01 +08:00
Added 1.7 release notes in TOC. 2013-07-10 05:04:37 +08:00			`1.7 release`
			`-----------`
			`.. toctree::`
			`:maxdepth: 1`

			`1.7`

Added release notes for 1.6. Since 1.5 is feature-frozen, we need them to document new features. 2012-10-30 21:02:54 +08:00			`1.6 release`
			`-----------`
			`.. toctree::`
			`:maxdepth: 1`

Added 1.6.2 release notes stub. 2013-12-14 07:42:24 +08:00			`1.6.2`
Fixed #21398 -- Fixed BCryptSHA256PasswordHasher with py-bcrypt and Python 3. Thanks arjan at anymore.nl for the report. 2013-11-09 19:36:10 +08:00			`1.6.1`
List 1.6.x releases in descending order 2013-12-05 05:32:41 +08:00			`1.6`
Added release notes for 1.6. Since 1.5 is feature-frozen, we need them to document new features. 2012-10-30 21:02:54 +08:00
Added stub release notes for 1.5 git-svn-id: http://code.djangoproject.com/svn/django/trunk@17831 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2012-03-30 17:33:51 +08:00			`1.5 release`
			`-----------`
			`.. toctree::`
			`:maxdepth: 1`

Added 1.5.5 and 1.4.9 release notes 2013-09-25 21:33:29 +08:00			`1.5.5`
Cleaned up 1.5.4/1.4.8 release notes 2013-09-16 02:14:26 +08:00			`1.5.4`
Added 1.4.7/1.5.3 release notes 2013-08-23 18:49:37 +08:00			`1.5.3`
Added 1.4.6/1.5.2 release notes. 2013-08-14 00:16:30 +08:00			`1.5.2`
Added 1.5.1 release notes. 2013-03-29 04:02:35 +08:00			`1.5.1`
Added stub release notes for 1.5 git-svn-id: http://code.djangoproject.com/svn/django/trunk@17831 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2012-03-30 17:33:51 +08:00			`1.5`

Added stub release notes for 1.4 git-svn-id: http://code.djangoproject.com/svn/django/trunk@15947 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-03-31 01:34:01 +08:00			`1.4 release`
			`-----------`
			`.. toctree::`
			`:maxdepth: 1`

Added 1.4.10 release notes. 2013-11-07 22:42:25 +08:00			`1.4.10`
Added 1.5.5 and 1.4.9 release notes 2013-09-25 21:33:29 +08:00			`1.4.9`
Cleaned up 1.5.4/1.4.8 release notes 2013-09-16 02:14:26 +08:00			`1.4.8`
Added 1.4.7/1.5.3 release notes 2013-08-23 18:49:37 +08:00			`1.4.7`
Added 1.4.6/1.5.2 release notes. 2013-08-14 00:16:30 +08:00			`1.4.6`
Added missing release notes for older versions of Django 2013-08-13 01:20:58 +08:00			`1.4.5`
			`1.4.4`
			`1.4.3`
Added 1.4.2 release notes 2012-10-19 00:55:14 +08:00			`1.4.2`
Added 1.4.1 and 1.3.2 release notes 2012-09-01 02:35:50 +08:00			`1.4.1`
Added stub release notes for 1.4 git-svn-id: http://code.djangoproject.com/svn/django/trunk@15947 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-03-31 01:34:01 +08:00			`1.4`

Added skeleton 1.3 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@13366 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-06-21 20:19:32 +08:00			`1.3 release`
			`-----------`
			`.. toctree::`
			`:maxdepth: 1`

Added missing release notes for older versions of Django 2013-08-13 01:20:58 +08:00			`1.3.7`
			`1.3.6`
			`1.3.5`
			`1.3.4`
			`1.3.3`
Added 1.4.1 and 1.3.2 release notes 2012-09-01 02:35:50 +08:00			`1.3.2`
Added basic release notes for 1.2.6 and 1.3.1. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16777 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-09-10 11:33:54 +08:00			`1.3.1`
Added skeleton 1.3 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@13366 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-06-21 20:19:32 +08:00			`1.3`

Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`1.2 release`
			`-----------`
Massive reorganization of the docs. See the new docs online at http://docs.djangoproject.com/. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8506 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2008-08-24 06:25:40 +08:00			`.. toctree::`
			`:maxdepth: 1`
Added a rough draft of the 1.0 porting guide, and an obviously incomplete placeholder for the 1.0 release notes. Thanks to daonb, patrickf, and ramiro for contributions to this porting guide. Refs #8438. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8856 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2008-09-03 00:27:47 +08:00
Added basic release notes for 1.2.7. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16803 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-09-11 10:28:08 +08:00			`1.2.7`
Added basic release notes for 1.2.6 and 1.3.1. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16777 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-09-10 11:33:54 +08:00			`1.2.6`
Copied in-development 1.2.5 release notes to trunk. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15323 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-01-26 16:10:54 +08:00			`1.2.5`
Fixed #14980 - Add 1.2.4 release notes to trunk. thanks Gary Wilson for the report. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15083 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-12-29 05:37:10 +08:00			`1.2.4`
Added placeholder release notes for the 1.2.1 and 1.2.3 releases. Both of these releases were to fix bugs in the previous release and, as such contained nothing new of significance. However, to complete the set of release note files in case anybody worries about the gaps, we now have documents explaining precisely that. Fixed #15330. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16695 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-08-26 17:31:01 +08:00			`1.2.3`
Fixed #14225 -- Added a documentation marker (and a 1.2.2 release notes file, required to satisfy Sphinx) for the enable_csrf_checks flag on the test client. Thanks to public@grep.ro for the report. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14011 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-10-08 22:48:04 +08:00			`1.2.2`
Added placeholder release notes for the 1.2.1 and 1.2.3 releases. Both of these releases were to fix bugs in the previous release and, as such contained nothing new of significance. However, to complete the set of release note files in case anybody worries about the gaps, we now have documents explaining precisely that. Fixed #15330. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16695 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-08-26 17:31:01 +08:00			`1.2.1`
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`1.2`

			`1.1 release`
			`-----------`
			`.. toctree::`
			`:maxdepth: 1`

Fixed #15253, #15259 -- Added 1.1.4 release notes, added a section on CSRF changes to the 1.3 release notes, and corrected the example in the 1.2.5 release notes. Thanks to Gary Wilson and Mark Hellewell for the reports. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15482 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-02-10 17:27:38 +08:00			`1.1.4`
Fixed #15253 -- Added 1.1.3 release notes, and added sections to the 1.2.4 and 1.3 release notes about the December security announcement. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15485 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-02-10 19:55:24 +08:00			`1.1.3`
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`1.1.2`
Added 1.1 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11362 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-07-29 13:31:00 +08:00			`1.1`
Massive reorganization of the docs. See the new docs online at http://docs.djangoproject.com/. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8506 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2008-08-24 06:25:40 +08:00
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`1.0 release`
			`-----------`
			`.. toctree::`
			`:maxdepth: 1`
Massive reorganization of the docs. See the new docs online at http://docs.djangoproject.com/. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8506 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2008-08-24 06:25:40 +08:00
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`1.0.2`
			`1.0.1`
			`1.0`

			`Pre-1.0 releases`
			`----------------`
			`.. toctree::`
			`:maxdepth: 1`

			`0.96`
			`0.95`

Fix #21121: Add archive of security issues. 2013-09-19 12:13:04 +08:00			`Security releases`
			`=================`

Corrected markup problems in new security summary page. 2013-09-19 13:57:02 +08:00			Whenever a security issue is disclosed via :doc:`Django's security
			policies </internals/security>`, appropriate release notes are now
Fix #21121: Add archive of security issues. 2013-09-19 12:13:04 +08:00			`added to all affected release series.`

Corrected markup problems in new security summary page. 2013-09-19 13:57:02 +08:00			Additionally, :doc:`an archive of disclosed security issues
			</releases/security>` is maintained.
Fix #21121: Add archive of security issues. 2013-09-19 12:13:04 +08:00
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`Development releases`
			`====================`
Added a rough draft of the 1.0 porting guide, and an obviously incomplete placeholder for the 1.0 release notes. Thanks to daonb, patrickf, and ramiro for contributions to this porting guide. Refs #8438. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8856 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2008-09-03 00:27:47 +08:00
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`These notes are retained for historical purposes. If you are upgrading`
			`between formal Django releases, you don't need to worry about these`
			`notes.`
Fixed #12198 - CSRF changes not clearly noted in docs. The docs no longer unhelpfully point to BackwardsIncompatibleChanges, and instead a section has been added to help those upgrading and those following trunk. Tentative 1.2 release notes added. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11738 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-15 03:13:33 +08:00
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`.. toctree::`
			`:maxdepth: 1`

Corrected markup problems in new security summary page. 2013-09-19 13:57:02 +08:00			`security`
Added 1.5 beta release notes. 2012-11-28 05:30:52 +08:00			`1.5-beta-1`
Added release notes for Django 1.5 alpha 1. Also updated 1.5-proper release notes a bit. 2012-10-26 02:59:13 +08:00			`1.5-alpha-1`
Fixed #17460 -- Extended the HIDDEN_SETTINGS constant in with a few more sensible names of settings to hide in the debug view. Many thanks to chomik, lpiatek and tomaszrybak. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17481 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2012-02-10 02:58:45 +08:00			`1.4-beta-1`
Added 1.4 alpha release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17242 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2011-12-23 04:18:54 +08:00			`1.4-alpha-1`
We're not going to have an alpha-2, so use those notes as the starting point for the beta notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14990 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-12-19 23:02:13 +08:00			`1.3-beta-1`
Add 1.3 alpha notes to release-notes index. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14522 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-11-11 15:21:07 +08:00			`1.3-alpha-1`
Added 1.2 RC1 docs to the releases index. git-svn-id: http://code.djangoproject.com/svn/django/trunk@13125 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-05-08 15:29:57 +08:00			`1.2-rc-1`
Add 1.2 beta release notes to release notes index. git-svn-id: http://code.djangoproject.com/svn/django/trunk@12391 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-02-06 13:25:50 +08:00			`1.2-beta-1`
Corrected some referencing problems in the docs. git-svn-id: http://code.djangoproject.com/svn/django/trunk@12117 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2010-01-07 19:38:14 +08:00			`1.2-alpha-1`
Cleaned up the release notes index page, and added some stub 1.1.2 and 1.2 release notes. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11760 bcc190cf-cafb-0310-a4f2-bffc1f526a37 2009-11-23 21:44:24 +08:00			`1.1-rc-1`
			`1.1-beta-1`
			`1.1-alpha-1`
			`1.0-beta-2`
			`1.0-beta`
			`1.0-alpha-2`
			`1.0-alpha-1`