diff --git a/docs/releases/1.0.txt b/docs/releases/1.0.txt index 3d0043a7977..65c185e82a5 100644 --- a/docs/releases/1.0.txt +++ b/docs/releases/1.0.txt @@ -22,7 +22,7 @@ contributions overtake those made privately. Stability and forwards-compatibility ==================================== -:doc:`The release of Django 1.0 ` comes with a promise of API +The release of Django 1.0 comes with a promise of API stability and forwards-compatibility. In a nutshell, this means that code you develop against Django 1.0 will continue to work against 1.1 unchanged, and you should need to make only minor changes for any 1.X release. diff --git a/docs/releases/1.1.txt b/docs/releases/1.1.txt index 63b8c9ab131..0b720661b4e 100644 --- a/docs/releases/1.1.txt +++ b/docs/releases/1.1.txt @@ -2,15 +2,12 @@ Django 1.1 release notes ======================== - July 29, 2009 Welcome to Django 1.1! -Django 1.1 includes a number of nifty `new features`_, lots of bug -fixes, and an easy upgrade path from Django 1.0. - -.. _new features: `What's new in Django 1.1`_ +Django 1.1 includes a number of nifty :ref:`new features `, lots +of bug fixes, and an easy upgrade path from Django 1.0. .. _backwards-incompatible-changes-1.1: @@ -175,6 +172,8 @@ be upgraded to a ``DeprecationWarning``, which will be displayed loudly. Django For more details on our deprecation policies and strategy, see :doc:`/internals/release-process`. +.. _whats-new-1.1: + What's new in Django 1.1 ======================== diff --git a/docs/releases/1.10.txt b/docs/releases/1.10.txt index 8d2cb4261df..7f62de6bb56 100644 --- a/docs/releases/1.10.txt +++ b/docs/releases/1.10.txt @@ -4,16 +4,12 @@ Django 1.10 release notes - UNDER DEVELOPMENT Welcome to Django 1.10! -These release notes cover the `new features`_, as well as some `backwards -incompatible changes`_ you'll want to be aware of when upgrading from Django -1.9 or older versions. We've :ref:`dropped some features` -that have reached the end of their deprecation cycle, and we've `begun the -deprecation process for some features`_. - -.. _`new features`: `What's new in Django 1.10`_ -.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.10`_ -.. _`dropped some features`: `Features removed in 1.10`_ -.. _`begun the deprecation process for some features`: `Features deprecated in 1.10`_ +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 1.9 or older versions. We've +:ref:`dropped some features ` that have reached the end +of their deprecation cycle, and we've :ref:`begun the deprecation process for +some features `. Python compatibility ==================== @@ -21,6 +17,8 @@ Python compatibility Like Django 1.9, Django 1.10 requires Python 2.7, 3.4, or 3.5. We **highly recommend** and only officially support the latest release of each series. +.. _whats-new-1.10: + What's new in Django 1.10 ========================= @@ -504,6 +502,8 @@ Validators ``allow_negative`` boolean parameter, defaulting to ``False``, to allow negative integers. +.. _backwards-incompatible-1.10: + Backwards incompatible changes in 1.10 ====================================== diff --git a/docs/releases/1.11.txt b/docs/releases/1.11.txt index 5a4f191912a..a2a427e7a47 100644 --- a/docs/releases/1.11.txt +++ b/docs/releases/1.11.txt @@ -4,14 +4,11 @@ Django 1.11 release notes - UNDER DEVELOPMENT Welcome to Django 1.11! -These release notes cover the `new features`_, as well as some `backwards -incompatible changes`_ you'll want to be aware of when upgrading from Django -1.10 or older versions. We've `begun the deprecation process for some -features`_. - -.. _`new features`: `What's new in Django 1.11`_ -.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.11`_ -.. _`begun the deprecation process for some features`: `Features deprecated in 1.11`_ +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 1.10 or older versions. We've +:ref:`begun the deprecation process for some features +`. Django 1.11 is designated as a :term:`long-term support release`. It will receive security updates for at least three years after its release. Support @@ -42,6 +39,8 @@ be able run your package's tests using ``python -Wd`` so that deprecation warnings do appear. After making the deprecation warning fixes, your app should be compatible with Django 2.0. +.. _whats-new-1.11: + What's new in Django 1.11 ========================= @@ -211,6 +210,8 @@ Validators * ... +.. _backwards-incompatible-1.11: + Backwards incompatible changes in 1.11 ====================================== diff --git a/docs/releases/1.2.txt b/docs/releases/1.2.txt index d680c1e72b0..07efc6607b7 100644 --- a/docs/releases/1.2.txt +++ b/docs/releases/1.2.txt @@ -6,12 +6,10 @@ Django 1.2 release notes Welcome to Django 1.2! -Nearly a year in the making, Django 1.2 packs an impressive list of `new -features`_ and lots of bug fixes. These release notes cover the new features, -as well as important changes you'll want to be aware of when upgrading from -Django 1.1 or older versions. - -.. _new features: `What's new in Django 1.2`_ +Nearly a year in the making, Django 1.2 packs an impressive list of :ref:`new +features ` and lots of bug fixes. These release notes cover +the new features, as well as important changes you'll want to be aware of when +upgrading from Django 1.1 or older versions. Overview ======== @@ -115,6 +113,8 @@ A roadmap for Django's overall 2.x Python support, and eventual transition to Python 3.x, is currently being developed, and will be announced prior to the release of Django 1.3. +.. _whats-new-1.2: + What's new in Django 1.2 ======================== @@ -1072,9 +1072,9 @@ to provide localizers the possibility to translate date and time formats. They were translatable :term:`translation strings ` that could be recognized because they were all upper case (for example :setting:`DATETIME_FORMAT`, :setting:`DATE_FORMAT`, :setting:`TIME_FORMAT`). -They have been deprecated in favor of the new :doc:`/topics/i18n/formatting` -infrastructure that allows localizers to specify that information in a -``formats.py`` file in the corresponding ``django/conf/locale//`` +They have been deprecated in favor of the new :doc:`/topics/i18n/formatting` +infrastructure that allows localizers to specify that information in a +``formats.py`` file in the corresponding ``django/conf/locale//`` directory. GeoDjango diff --git a/docs/releases/1.3.txt b/docs/releases/1.3.txt index 61d23457d6d..96d1935932b 100644 --- a/docs/releases/1.3.txt +++ b/docs/releases/1.3.txt @@ -6,11 +6,11 @@ Django 1.3 release notes Welcome to Django 1.3! -Nearly a year in the making, Django 1.3 includes quite a few `new -features`_ and plenty of bug fixes and improvements to existing -features. These release notes cover the new features in 1.3, as well -as some `backwards-incompatible changes`_ you'll want to be aware of -when upgrading from Django 1.2 or older versions. +Nearly a year in the making, Django 1.3 includes quite a few :ref:`new features +` and plenty of bug fixes and improvements to existing features. +These release notes cover the new features in 1.3, as well as some +:ref:`backwards-incompatible changes ` +you'll want to be aware of when upgrading from Django 1.2 or older versions. Overview ======== @@ -28,27 +28,15 @@ new features from landing, including: * Django's testing framework now supports (and ships with a copy of) `the unittest2 library`_. -There's plenty more, of course; see the coverage of `new features`_ -below for a full rundown and details. - Wherever possible, of course, new features are introduced in a backwards-compatible manner per :doc:`our API stability policy ` policy. As a result of this policy, Django 1.3 -`begins the deprecation process for some features`_. +:ref:`begins the deprecation process for some features +`. -Some changes, unfortunately, are genuinely backwards-incompatible; in -most cases these are due to security issues or bugs which simply -couldn't be fixed any other way. Django 1.3 includes a few of these, -and descriptions of them -- along with the (minor) modifications -you'll need to make to handle them -- are documented in the list of -`backwards-incompatible changes`_ below. - -.. _new features: `What's new in Django 1.3`_ -.. _backwards-incompatible changes: backwards-incompatible-changes-1.3_ .. _using Python's logging facilities: `Logging`_ .. _easy handling of static files: `Extended static files handling`_ .. _the unittest2 library: `unittest2 support`_ -.. _begins the deprecation process for some features: `deprecated-features-1.3`_ Python compatibility ==================== @@ -64,6 +52,8 @@ supported Python version will be 2.5. A document outlining our full timeline for deprecating Python 2.x and moving to Python 3.x will be published shortly after the release of Django 1.3. +.. _whats-new-1.3: + What's new in Django 1.3 ======================== diff --git a/docs/releases/1.4.txt b/docs/releases/1.4.txt index 1b7132c3c9d..2e1149992cd 100644 --- a/docs/releases/1.4.txt +++ b/docs/releases/1.4.txt @@ -6,16 +6,12 @@ Django 1.4 release notes Welcome to Django 1.4! -These release notes cover the `new features`_, as well -as some `backwards incompatible changes`_ you'll want to be aware of -when upgrading from Django 1.3 or older versions. We've also dropped some -features, which are detailed in :ref:`our deprecation plan -`, and we've `begun the deprecation process for -some features`_. - -.. _`new features`: `What's new in Django 1.4`_ -.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.4`_ -.. _`begun the deprecation process for some features`: `Features deprecated in 1.4`_ +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 1.3 or older versions. We've +also dropped some features, which are detailed in :ref:`our deprecation plan +`, and we've :ref:`begun the deprecation process +for some features `. Overview ======== @@ -56,8 +52,8 @@ Other notable new features in Django 1.4 include: Wherever possible we try to introduce new features in a backwards-compatible manner per :doc:`our API stability policy ` policy. However, as with previous releases, Django 1.4 ships with some minor -`backwards incompatible changes`_; people upgrading from previous versions -of Django should read that list carefully. +:ref:`backwards incompatible changes `; people +upgrading from previous versions of Django should read that list carefully. Python compatibility ==================== @@ -77,6 +73,8 @@ Django does not support Python 3.x at this time. At some point before the release of Django 1.4, we plan to publish a document outlining our full timeline for deprecating Python 2.x and moving to Python 3.x. +.. _whats-new-1.4: + What's new in Django 1.4 ======================== @@ -662,6 +660,8 @@ Django 1.4 also includes several smaller improvements worth noting: useful in tests that don't need to hit a database. See :ref:`testcase_hierarchy_diagram`. +.. _backwards-incompatible-1.4: + Backwards incompatible changes in 1.4 ===================================== diff --git a/docs/releases/1.5.txt b/docs/releases/1.5.txt index 21da0dca611..9d63f3d573d 100644 --- a/docs/releases/1.5.txt +++ b/docs/releases/1.5.txt @@ -6,16 +6,12 @@ Django 1.5 release notes Welcome to Django 1.5! -These release notes cover the `new features`_, as well -as some `backwards incompatible changes`_ you'll want to be aware of -when upgrading from Django 1.4 or older versions. We've also dropped some -features, which are detailed in :ref:`our deprecation plan -`, and we've `begun the deprecation process for -some features`_. - -.. _`new features`: `What's new in Django 1.5`_ -.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.5`_ -.. _`begun the deprecation process for some features`: `Features deprecated in 1.5`_ +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 1.4 or older versions. We've +also dropped some features, which are detailed in :ref:`our deprecation plan +`, and we've :ref:`begun the deprecation process +for some features `. Overview ======== @@ -51,8 +47,8 @@ Other notable new features in Django 1.5 include: Wherever possible we try to introduce new features in a backwards-compatible manner per :doc:`our API stability policy `. However, as with previous releases, Django 1.5 ships with some minor -`backwards incompatible changes`_; people upgrading from previous versions -of Django should read that list carefully. +:ref:`backwards incompatible changes `; people +upgrading from previous versions of Django should read that list carefully. One deprecated feature worth noting is the shift to "new-style" :ttag:`url` tag. Prior to Django 1.3, syntax like ``{% url myview %}`` was interpreted @@ -118,6 +114,8 @@ to start porting now. We plan to offer first-class, production-ready support for Python 3 in our next release, Django 1.6. +.. _whats-new-1.5: + What's new in Django 1.5 ======================== @@ -347,6 +345,8 @@ Django 1.5 also includes several smaller improvements worth noting: * The admin's list filters can now be customized per-request thanks to the new :meth:`django.contrib.admin.ModelAdmin.get_list_filter` method. +.. _backwards-incompatible-1.5: + Backwards incompatible changes in 1.5 ===================================== diff --git a/docs/releases/1.6.txt b/docs/releases/1.6.txt index 4213bc86b73..421a6cc1935 100644 --- a/docs/releases/1.6.txt +++ b/docs/releases/1.6.txt @@ -24,15 +24,12 @@ Welcome to Django 1.6! -These release notes cover the `new features`_, as well as some `backwards -incompatible changes`_ you'll want to be aware of when upgrading from Django -1.5 or older versions. We've also dropped some features, which are detailed in -:ref:`our deprecation plan `, and we've `begun the -deprecation process for some features`_. - -.. _`new features`: `What's new in Django 1.6`_ -.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.6`_ -.. _`begun the deprecation process for some features`: `Features deprecated in 1.6`_ +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 1.5 or older versions. We've +also dropped some features, which are detailed in :ref:`our deprecation plan +`, and we've :ref:`begun the deprecation process +for some features `. Python compatibility ==================== @@ -46,6 +43,8 @@ with Django 1.7, the minimum supported Python version will be 2.7. Python 3.4 is not supported, but support will be added in Django 1.7. +.. _whats-new-1.6: + What's new in Django 1.6 ======================== @@ -369,6 +368,8 @@ Minor features default value. Passwords :ref:`will be upgraded ` to use the new iteration count as necessary. +.. _backwards-incompatible-1.6: + Backwards incompatible changes in 1.6 ===================================== diff --git a/docs/releases/1.7.txt b/docs/releases/1.7.txt index 0041b631183..7cece39eccd 100644 --- a/docs/releases/1.7.txt +++ b/docs/releases/1.7.txt @@ -6,16 +6,12 @@ Django 1.7 release notes Welcome to Django 1.7! -These release notes cover the `new features`_, as well as some `backwards -incompatible changes`_ you'll want to be aware of when upgrading from Django -1.6 or older versions. We've `begun the deprecation process for some features`_, -and some features have reached the end of their deprecation process and -`have been removed`_. - -.. _`new features`: `What's new in Django 1.7`_ -.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.7`_ -.. _`begun the deprecation process for some features`: `Features deprecated in 1.7`_ -.. _`have been removed`: `Features removed in 1.7`_ +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 1.6 or older versions. We've +:ref:`begun the deprecation process for some features +`, and some features have reached the end of their +deprecation process and :ref:`have been removed `. Python compatibility ==================== @@ -33,6 +29,8 @@ Django 1.6 until you can upgrade your Python version. Per :doc:`our support policy `, Django 1.6 will continue to receive security support until the release of Django 1.8. +.. _whats-new-1.7: + What's new in Django 1.7 ======================== @@ -937,6 +935,8 @@ Validators * :func:`~django.core.validators.validate_email` now accepts addresses with IPv6 literals, like ``example@[2001:db8::1]``, as specified in RFC 5321. +.. _backwards-incompatible-1.7: + Backwards incompatible changes in 1.7 ===================================== @@ -1803,7 +1803,7 @@ Private APIs ``django.db.models.sql.where.WhereNode.make_atom()`` and ``django.db.models.sql.where.Constraint`` are deprecated in favor of the new :doc:`custom lookups API `. -.. removed-features-1.7: +.. _removed-features-1.7: Features removed in 1.7 ======================= diff --git a/docs/releases/1.8.txt b/docs/releases/1.8.txt index a6d425e8d86..bedb6a9081b 100644 --- a/docs/releases/1.8.txt +++ b/docs/releases/1.8.txt @@ -6,22 +6,18 @@ Django 1.8 release notes Welcome to Django 1.8! -These release notes cover the `new features`_, as well as some `backwards -incompatible changes`_ you'll want to be aware of when upgrading from Django -1.7 or older versions. We've also `begun the deprecation process for some -features`_, and some features have reached the end of their deprecation process -and `have been removed`_. +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 1.7 or older versions. We've +also :ref:`begun the deprecation process for some features +`, and some features have reached the end of their +deprecation process and :ref:`have been removed `. Django 1.8 has been designated as Django's second :term:`long-term support release`. It will receive security updates for at least three years after its release. Support for the previous LTS, Django 1.4, will end 6 months from the release date of Django 1.8. -.. _`new features`: `What's new in Django 1.8`_ -.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.8`_ -.. _`begun the deprecation process for some features`: `Features deprecated in 1.8`_ -.. _`have been removed`: `Features removed in 1.8`_ - Python compatibility ==================== @@ -33,6 +29,8 @@ Django 1.8 is the first release to support Python 3.5. Due to the end of upstream support for Python 3.2 in February 2016, we won't test Django 1.8.x on Python 3.2 after the end of 2016. +.. _whats-new-1.8: + What's new in Django 1.8 ======================== @@ -661,6 +659,8 @@ Validators * :class:`~django.core.validators.URLValidator` now supports IPv6 addresses, unicode domains, and URLs containing authentication data. +.. _backwards-incompatible-1.8: + Backwards incompatible changes in 1.8 ===================================== @@ -1705,7 +1705,7 @@ After switching to the new signature the router will also be called by the :class:`~django.db.migrations.operations.RunPython` and :class:`~django.db.migrations.operations.RunSQL` operations. -.. removed-features-1.8: +.. _removed-features-1.8: Features removed in 1.8 ======================= diff --git a/docs/releases/1.9.txt b/docs/releases/1.9.txt index dfdff5d6efa..1bc2ba251f1 100644 --- a/docs/releases/1.9.txt +++ b/docs/releases/1.9.txt @@ -6,16 +6,12 @@ Django 1.9 release notes Welcome to Django 1.9! -These release notes cover the `new features`_, as well as some `backwards -incompatible changes`_ you'll want to be aware of when upgrading from Django -1.8 or older versions. We've :ref:`dropped some features` -that have reached the end of their deprecation cycle, and we've `begun the -deprecation process for some features`_. - -.. _`new features`: `What's new in Django 1.9`_ -.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.9`_ -.. _`dropped some features`: `Features removed in 1.9`_ -.. _`begun the deprecation process for some features`: `Features deprecated in 1.9`_ +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 1.8 or older versions. We've +:ref:`dropped some features` that have reached the end of +their deprecation cycle, and we've :ref:`begun the deprecation process for some +features `. Python compatibility ==================== @@ -25,6 +21,8 @@ officially support the latest release of each series. The Django 1.8 series is the last to support Python 3.2 and 3.3. +.. _whats-new-1.9: + What's new in Django 1.9 ======================== @@ -672,6 +670,8 @@ Validators * Added :func:`~django.core.validators.validate_unicode_slug` to validate slugs that may contain Unicode characters. +.. _backwards-incompatible-1.9: + Backwards incompatible changes in 1.9 =====================================