p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Corrected wrapping in 3.2 release notes. 

Partially reverts 0802b404a2.
This commit is contained in:
Carlton Gibson 2021-04-07 07:27:31 +02:00 committed by GitHub
parent da542ccab6
commit 5b05a45c62
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 50 additions and 51 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

101
docs/releases/3.2.txt
View File

@ -169,11 +169,11 @@ Minor features
:mod:`django.contrib.admin` :mod:`django.contrib.admin`
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
* :attr:`.ModelAdmin.search_fields` now allows searching against quoted * :attr:`.ModelAdmin.search_fields` now allows searching against quoted phrases
phrases with spaces. with spaces.
* Read-only related fields are now rendered as navigable links if target * Read-only related fields are now rendered as navigable links if target models
models are registered in the admin. are registered in the admin.
* The admin now supports theming, and includes a dark theme that is enabled * The admin now supports theming, and includes a dark theme that is enabled
according to browser settings. See :ref:`admin-theming` for more details. according to browser settings. See :ref:`admin-theming` for more details.
@ -341,8 +341,8 @@ Generic Views
Management Commands Management Commands
~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~
* :djadmin:`loaddata` now supports fixtures stored in XZ archives (``.xz``) * :djadmin:`loaddata` now supports fixtures stored in XZ archives (``.xz``) and
and LZMA archives (``.lzma``). LZMA archives (``.lzma``).
* :djadmin:`dumpdata` now can compress data in the ``bz2``, ``gz``, ``lzma``, * :djadmin:`dumpdata` now can compress data in the ``bz2``, ``gz``, ``lzma``,
or ``xz`` formats. or ``xz`` formats.
@ -351,10 +351,10 @@ Management Commands
connection. In that case, check for a consistent migration history is connection. In that case, check for a consistent migration history is
skipped. skipped.
* :attr:`.BaseCommand.requires_system_checks` now supports specifying a list * :attr:`.BaseCommand.requires_system_checks` now supports specifying a list of
of tags. System checks registered in the chosen tags will be checked for tags. System checks registered in the chosen tags will be checked for errors
errors prior to executing the command. In previous versions, either all or prior to executing the command. In previous versions, either all or none
none of the system checks were performed. of the system checks were performed.
* Support for colored terminal output on Windows is updated. Various modern * Support for colored terminal output on Windows is updated. Various modern
terminal environments are automatically detected, and the options for terminal environments are automatically detected, and the options for
@ -382,14 +382,14 @@ Models
using the ``condition`` argument with ``lookups``. using the ``condition`` argument with ``lookups``.
* The new :attr:`.Index.include` and :attr:`.UniqueConstraint.include` * The new :attr:`.Index.include` and :attr:`.UniqueConstraint.include`
attributes allow creating covering indexes and covering unique constraints attributes allow creating covering indexes and covering unique constraints on
on PostgreSQL 11+. PostgreSQL 11+.
* The new :attr:`.UniqueConstraint.opclasses` attribute allows setting * The new :attr:`.UniqueConstraint.opclasses` attribute allows setting
PostgreSQL operator classes. PostgreSQL operator classes.
* The :meth:`.QuerySet.update` method now respects the ``order_by()`` clause * The :meth:`.QuerySet.update` method now respects the ``order_by()`` clause on
on MySQL and MariaDB. MySQL and MariaDB.
* :class:`FilteredRelation() <django.db.models.FilteredRelation>` now supports * :class:`FilteredRelation() <django.db.models.FilteredRelation>` now supports
nested relations. nested relations.
@ -448,16 +448,16 @@ Pagination
~~~~~~~~~~ ~~~~~~~~~~
* The new :meth:`django.core.paginator.Paginator.get_elided_page_range` method * The new :meth:`django.core.paginator.Paginator.get_elided_page_range` method
allows generating a page range with some of the values elided. If there are allows generating a page range with some of the values elided. If there are a
a large number of pages, this can be helpful for generating a reasonable large number of pages, this can be helpful for generating a reasonable number
number of page links in a template. of page links in a template.
Requests and Responses Requests and Responses
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
* Response headers are now stored in :attr:`.HttpResponse.headers`. This can * Response headers are now stored in :attr:`.HttpResponse.headers`. This can be
be used instead of the original dict-like interface of ``HttpResponse`` used instead of the original dict-like interface of ``HttpResponse`` objects.
objects. Both interfaces will continue to be supported. See Both interfaces will continue to be supported. See
:ref:`setting-header-fields` for details. :ref:`setting-header-fields` for details.
* The new ``headers`` parameter of :class:`~django.http.HttpResponse`, * The new ``headers`` parameter of :class:`~django.http.HttpResponse`,
@ -468,17 +468,17 @@ Requests and Responses
Security Security
~~~~~~~~ ~~~~~~~~
* The :setting:`SECRET_KEY` setting is now checked for a valid value upon * The :setting:`SECRET_KEY` setting is now checked for a valid value upon first
first access, rather than when settings are first loaded. This enables access, rather than when settings are first loaded. This enables running
running management commands that do not rely on the ``SECRET_KEY`` without management commands that do not rely on the ``SECRET_KEY`` without needing to
needing to provide a value. As a consequence of this, calling provide a value. As a consequence of this, calling
:func:`~django.conf.settings.configure` without providing a valid :func:`~django.conf.settings.configure` without providing a valid
``SECRET_KEY``, and then going on to access ``settings.SECRET_KEY`` will now ``SECRET_KEY``, and then going on to access ``settings.SECRET_KEY`` will now
raise an :exc:`~django.core.exceptions.ImproperlyConfigured` exception. raise an :exc:`~django.core.exceptions.ImproperlyConfigured` exception.
* The new ``Signer.sign_object()`` and ``Signer.unsign_object()`` methods * The new ``Signer.sign_object()`` and ``Signer.unsign_object()`` methods allow
allow signing complex data structures. See :ref:`signing-complex-data` for signing complex data structures. See :ref:`signing-complex-data` for more
more details. details.
Also, :func:`signing.dumps() <django.core.signing.dumps>` and Also, :func:`signing.dumps() <django.core.signing.dumps>` and
:func:`~django.core.signing.loads` become shortcuts for :func:`~django.core.signing.loads` become shortcuts for
@ -535,22 +535,22 @@ Tests
* :meth:`.TransactionTestCase.assertQuerysetEqual` now supports direct * :meth:`.TransactionTestCase.assertQuerysetEqual` now supports direct
comparison against another queryset rather than being restricted to comparison against another queryset rather than being restricted to
comparison against a list of string representations of objects when using comparison against a list of string representations of objects when using the
the default value for the ``transform`` argument. default value for the ``transform`` argument.
Utilities Utilities
~~~~~~~~~ ~~~~~~~~~
* The new ``depth`` parameter of ``django.utils.timesince.timesince()`` and * The new ``depth`` parameter of ``django.utils.timesince.timesince()`` and
``django.utils.timesince.timeuntil()`` functions allows specifying the ``django.utils.timesince.timeuntil()`` functions allows specifying the number
number of adjacent time units to return. of adjacent time units to return.
Validators Validators
~~~~~~~~~~ ~~~~~~~~~~
* Built-in validators now include the provided value in the ``params`` * Built-in validators now include the provided value in the ``params`` argument
argument of a raised :exc:`~django.core.exceptions.ValidationError`. This of a raised :exc:`~django.core.exceptions.ValidationError`. This allows
allows custom error messages to use the ``%(value)s`` placeholder. custom error messages to use the ``%(value)s`` placeholder.
* The :class:`.ValidationError` equality operator now ignores ``messages`` and * The :class:`.ValidationError` equality operator now ignores ``messages`` and
``params`` ordering. ``params`` ordering.
@ -566,8 +566,8 @@ Database backend API
This section describes changes that may be needed in third-party database This section describes changes that may be needed in third-party database
backends. backends.
* The new ``DatabaseFeatures.introspected_field_types`` property replaces * The new ``DatabaseFeatures.introspected_field_types`` property replaces these
these features: features:
* ``can_introspect_autofield`` * ``can_introspect_autofield``
* ``can_introspect_big_integer_field`` * ``can_introspect_big_integer_field``
@ -608,8 +608,8 @@ backends.
* Third-party database backends must implement support for functional indexes * Third-party database backends must implement support for functional indexes
(:attr:`.Index.expressions`) or set (:attr:`.Index.expressions`) or set
``DatabaseFeatures.supports_expression_indexes`` to ``False``. If ``DatabaseFeatures.supports_expression_indexes`` to ``False``. If ``COLLATE``
``COLLATE`` is not a part of the ``CREATE INDEX`` statement, set is not a part of the ``CREATE INDEX`` statement, set
``DatabaseFeatures.collate_as_index_expression`` to ``True``. ``DatabaseFeatures.collate_as_index_expression`` to ``True``.
:mod:`django.contrib.admin` :mod:`django.contrib.admin`
@ -626,9 +626,8 @@ backends.
* Minified JavaScript files are no longer included with the admin. If you * Minified JavaScript files are no longer included with the admin. If you
require these files to be minified, consider using a third party app or require these files to be minified, consider using a third party app or
external build tool. The minified vendored JavaScript files packaged with external build tool. The minified vendored JavaScript files packaged with the
the admin (e.g. :ref:`jquery.min.js <contrib-admin-jquery>`) are still admin (e.g. :ref:`jquery.min.js <contrib-admin-jquery>`) are still included.
included.
* :attr:`.ModelAdmin.prepopulated_fields` no longer strips English stop words, * :attr:`.ModelAdmin.prepopulated_fields` no longer strips English stop words,
such as ``'a'`` or ``'an'``. such as ``'a'`` or ``'an'``.
@ -684,9 +683,9 @@ Miscellaneous
* When an application defines an :class:`~django.apps.AppConfig` subclass in * When an application defines an :class:`~django.apps.AppConfig` subclass in
an ``apps.py`` submodule, Django now uses this configuration automatically, an ``apps.py`` submodule, Django now uses this configuration automatically,
even if it isn't enabled with ``default_app_config``. Set even if it isn't enabled with ``default_app_config``. Set ``default = False``
``default = False`` in the :class:`~django.apps.AppConfig` subclass if you in the :class:`~django.apps.AppConfig` subclass if you need to prevent this
need to prevent this behavior. See :ref:`whats-new-3.2` for more details. behavior. See :ref:`whats-new-3.2` for more details.
* Instantiating an abstract model now raises ``TypeError``. * Instantiating an abstract model now raises ``TypeError``.
@ -717,12 +716,12 @@ Miscellaneous
* The password reset mechanism now invalidates tokens when the user email is * The password reset mechanism now invalidates tokens when the user email is
changed. changed.
* :djadmin:`makemessages` command no longer processes invalid locales * :djadmin:`makemessages` command no longer processes invalid locales specified
specified using :option:`makemessages --locale` option, when they contain using :option:`makemessages --locale` option, when they contain hyphens
hyphens (``'-'``). (``'-'``).
* The ``django.contrib.auth.forms.ReadOnlyPasswordHashField`` form field is * The ``django.contrib.auth.forms.ReadOnlyPasswordHashField`` form field is now
now :attr:`~django.forms.Field.disabled` by default. Therefore :attr:`~django.forms.Field.disabled` by default. Therefore
``UserChangeForm.clean_password()`` is no longer required to return the ``UserChangeForm.clean_password()`` is no longer required to return the
initial value. initial value.
@ -756,8 +755,8 @@ Miscellaneous
:meth:`.TestCase.setUpTestData` is deprecated. :meth:`.TestCase.setUpTestData` is deprecated.
* Using a boolean value in :attr:`.BaseCommand.requires_system_checks` is * Using a boolean value in :attr:`.BaseCommand.requires_system_checks` is
deprecated. Use ``'__all__'`` instead of ``True``, and ``[]`` (an empty deprecated. Use ``'__all__'`` instead of ``True``, and ``[]`` (an empty list)
list) instead of ``False``. instead of ``False``.
* The ``whitelist`` argument and ``domain_whitelist`` attribute of * The ``whitelist`` argument and ``domain_whitelist`` attribute of
:class:`~django.core.validators.EmailValidator` are deprecated. Use :class:`~django.core.validators.EmailValidator` are deprecated. Use