diff options
| author | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2021-01-05 11:20:50 +0100 |
|---|---|---|
| committer | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2021-01-14 17:50:04 +0100 |
| commit | b7dd89ed5389067cb70294682ffef1ba23d33934 (patch) | |
| tree | 9d1cf97b9fda1ea8798cd543aee9d3f738a931f2 /docs/ref | |
| parent | 8774b1144c08f18e23381ffae7084dbc05ebfe37 (diff) | |
Removed versionadded/changed annotations for 3.1.
Diffstat (limited to 'docs/ref')
28 files changed, 0 insertions, 284 deletions
diff --git a/docs/ref/checks.txt b/docs/ref/checks.txt index b07a81f413..48ffb8c816 100644 --- a/docs/ref/checks.txt +++ b/docs/ref/checks.txt @@ -93,15 +93,6 @@ Django's system checks are organized using the following tags: Some checks may be registered with multiple tags. -.. versionchanged:: 3.1 - - The ``async_support`` tag was added. - -.. versionchanged:: 3.1 - - The ``database`` checks are now run only for database aliases specified - using the :option:`check --database` option. - .. versionchanged:: 3.2 The ``sites`` tag was added. @@ -112,8 +103,6 @@ Core system checks Asynchronous support -------------------- -.. versionadded:: 3.1 - The following checks verify your setup for :doc:`/topics/async`: * **async.E001**: You should not set the :envvar:`DJANGO_ALLOW_ASYNC_UNSAFE` diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index c6135ca5cb..0a42199c34 100644 --- a/docs/ref/contrib/admin/index.txt +++ b/docs/ref/contrib/admin/index.txt @@ -40,12 +40,6 @@ If you're not using the default project template, here are the requirements: the ``'context_processors'`` option of :setting:`OPTIONS <TEMPLATES-OPTIONS>`. - .. versionchanged:: 3.1 - - ``django.template.context_processors.request`` was added as a - requirement in the ``'context_processors'`` option to support the new - :attr:`.AdminSite.enable_nav_sidebar`. - #. If you've customized the :setting:`MIDDLEWARE` setting, :class:`django.contrib.auth.middleware.AuthenticationMiddleware` and :class:`django.contrib.messages.middleware.MessageMiddleware` must be @@ -1042,10 +1036,6 @@ subclass:: The :class:`~django.contrib.contenttypes.fields.GenericForeignKey` field is not supported. - .. versionadded:: 3.1 - - The ``EmptyFieldListFilter`` class was added. - List filter's typically appear only if the filter has more than one choice. A filter's ``has_output()`` method controls whether or not it appears. @@ -2230,10 +2220,6 @@ To avoid conflicts with user-supplied scripts or libraries, Django's jQuery in your own admin JavaScript without including a second copy, you can use the ``django.jQuery`` object on changelist and add/edit views. -.. versionchanged:: 3.1 - - jQuery was upgraded from 3.4.1 to 3.5.1. - The :class:`ModelAdmin` class requires jQuery by default, so there is no need to add jQuery to your ``ModelAdmin``’s list of media resources unless you have a specific need. For example, if you require the jQuery library to be in the @@ -2953,8 +2939,6 @@ Templates can override or extend base admin templates as described in .. attribute:: AdminSite.enable_nav_sidebar - .. versionadded:: 3.1 - A boolean value that determines whether to show the navigation sidebar on larger screens. By default, it is set to ``True``. diff --git a/docs/ref/contrib/auth.txt b/docs/ref/contrib/auth.txt index de2a2321ba..6bcdf5e099 100644 --- a/docs/ref/contrib/auth.txt +++ b/docs/ref/contrib/auth.txt @@ -40,10 +40,6 @@ Fields Optional (:attr:`blank=True <django.db.models.Field.blank>`). 150 characters or fewer. - .. versionchanged:: 3.1 - - The ``max_length`` increased from 30 to 150 characters. - .. attribute:: last_name Optional (:attr:`blank=True <django.db.models.Field.blank>`). 150 diff --git a/docs/ref/contrib/gis/functions.txt b/docs/ref/contrib/gis/functions.txt index 351429b49e..9f7043c2b0 100644 --- a/docs/ref/contrib/gis/functions.txt +++ b/docs/ref/contrib/gis/functions.txt @@ -83,10 +83,6 @@ Keyword Argument Description Oracle. ===================== ===================================================== -.. versionchanged:: 3.1 - - Oracle support was added. - ``AsGML`` ========= @@ -144,10 +140,6 @@ Keyword Argument Description __ https://developers.google.com/kml/documentation/ -.. versionchanged:: 3.1 - - The undocumented ``version`` parameter was removed. - ``AsSVG`` ========= @@ -177,8 +169,6 @@ __ https://www.w3.org/Graphics/SVG/ .. class:: AsWKB(expression, **extra) -.. versionadded:: 3.1 - *Availability*: MariaDB, `MySQL <https://dev.mysql.com/doc/refman/en/gis-format-conversion-functions.html#function_st-asbinary>`__, Oracle, `PostGIS <https://postgis.net/docs/ST_AsBinary.html>`__, SpatiaLite @@ -198,8 +188,6 @@ __ https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well .. class:: AsWKT(expression, **extra) -.. versionadded:: 3.1 - *Availability*: MariaDB, `MySQL <https://dev.mysql.com/doc/refman/en/gis-format-conversion-functions.html#function_st-astext>`__, Oracle, `PostGIS <https://postgis.net/docs/ST_AsText.html>`__, SpatiaLite diff --git a/docs/ref/contrib/gis/geoquerysets.txt b/docs/ref/contrib/gis/geoquerysets.txt index dfda2fa3b7..9a8bb3f29f 100644 --- a/docs/ref/contrib/gis/geoquerysets.txt +++ b/docs/ref/contrib/gis/geoquerysets.txt @@ -439,10 +439,6 @@ PostGIS SQL equivalent: SELECT ... WHERE ST_Relate(poly, ST_Polygon(rast, 1), 'T*T***FF*') SELECT ... WHERE ST_Relate(ST_Polygon(rast, 2), ST_Polygon(rast, 1), 'T*T***FF*') -.. versionchanged:: 3.1 - - MariaDB support was added. - Oracle ~~~~~~ diff --git a/docs/ref/contrib/gis/geos.txt b/docs/ref/contrib/gis/geos.txt index 446fb38108..e2713439fc 100644 --- a/docs/ref/contrib/gis/geos.txt +++ b/docs/ref/contrib/gis/geos.txt @@ -729,8 +729,6 @@ Other Properties & Methods .. attribute:: is_counterclockwise - .. versionadded:: 3.1 - Returns whether this ``LinearRing`` is counterclockwise. ``Polygon`` diff --git a/docs/ref/contrib/humanize.txt b/docs/ref/contrib/humanize.txt index 00718582f5..7c1af53ed3 100644 --- a/docs/ref/contrib/humanize.txt +++ b/docs/ref/contrib/humanize.txt @@ -78,10 +78,6 @@ e.g. with the ``'de'`` language: * ``1200000000`` becomes ``'1,2 Milliarden'``. * ``-1200000000`` becomes ``'-1,2 Milliarden'``. -.. versionchanged:: 3.1 - - Support for negative integers was added. - .. templatefilter:: naturalday ``naturalday`` diff --git a/docs/ref/contrib/postgres/constraints.txt b/docs/ref/contrib/postgres/constraints.txt index 25e6ae5ae0..7907eaefdf 100644 --- a/docs/ref/contrib/postgres/constraints.txt +++ b/docs/ref/contrib/postgres/constraints.txt @@ -79,8 +79,6 @@ These conditions have the same database restrictions as .. attribute:: ExclusionConstraint.deferrable -.. versionadded:: 3.1 - Set this parameter to create a deferrable exclusion constraint. Accepted values are ``Deferrable.DEFERRED`` or ``Deferrable.IMMEDIATE``. For example:: diff --git a/docs/ref/contrib/postgres/fields.txt b/docs/ref/contrib/postgres/fields.txt index df9ebc48d6..eee99592b3 100644 --- a/docs/ref/contrib/postgres/fields.txt +++ b/docs/ref/contrib/postgres/fields.txt @@ -686,14 +686,6 @@ The ``contained_by`` lookup is also available on the non-range field types: ... ) <QuerySet [<Event: Soft play>]> -.. versionchanged:: 3.1 - - Support for :class:`~django.db.models.SmallAutoField`, - :class:`~django.db.models.AutoField`, - :class:`~django.db.models.BigAutoField`, - :class:`~django.db.models.SmallIntegerField`, and - :class:`~django.db.models.DecimalField` was added. - .. fieldlookup:: rangefield.overlap ``overlap`` @@ -813,8 +805,6 @@ Returned objects are empty ranges. Can be chained to valid lookups for a ``lower_inc`` ^^^^^^^^^^^^^ -.. versionadded:: 3.1 - Returns objects that have inclusive or exclusive lower bounds, depending on the boolean value passed. Can be chained to valid lookups for a :class:`~django.db.models.BooleanField`. @@ -827,8 +817,6 @@ boolean value passed. Can be chained to valid lookups for a ``lower_inf`` ^^^^^^^^^^^^^ -.. versionadded:: 3.1 - Returns objects that have unbounded (infinite) or bounded lower bound, depending on the boolean value passed. Can be chained to valid lookups for a :class:`~django.db.models.BooleanField`. @@ -841,8 +829,6 @@ depending on the boolean value passed. Can be chained to valid lookups for a ``upper_inc`` ^^^^^^^^^^^^^ -.. versionadded:: 3.1 - Returns objects that have inclusive or exclusive upper bounds, depending on the boolean value passed. Can be chained to valid lookups for a :class:`~django.db.models.BooleanField`. @@ -855,8 +841,6 @@ boolean value passed. Can be chained to valid lookups for a ``upper_inf`` ^^^^^^^^^^^^^ -.. versionadded:: 3.1 - Returns objects that have unbounded (infinite) or bounded upper bound, depending on the boolean value passed. Can be chained to valid lookups for a :class:`~django.db.models.BooleanField`. diff --git a/docs/ref/contrib/postgres/indexes.txt b/docs/ref/contrib/postgres/indexes.txt index 4a9b2ad22e..746e26330e 100644 --- a/docs/ref/contrib/postgres/indexes.txt +++ b/docs/ref/contrib/postgres/indexes.txt @@ -12,8 +12,6 @@ available from the ``django.contrib.postgres.indexes`` module. .. class:: BloomIndex(*expressions, length=None, columns=(), **options) - .. versionadded:: 3.1 - Creates a bloom_ index. To use this index access you need to activate the bloom_ extension on diff --git a/docs/ref/contrib/postgres/operations.txt b/docs/ref/contrib/postgres/operations.txt index ff37728d27..8491ac2f52 100644 --- a/docs/ref/contrib/postgres/operations.txt +++ b/docs/ref/contrib/postgres/operations.txt @@ -61,8 +61,6 @@ them. In that case, connect to your Django database and run the query .. class:: BloomExtension() - .. versionadded:: 3.1 - Installs the ``bloom`` extension. ``BtreeGinExtension`` diff --git a/docs/ref/contrib/postgres/search.txt b/docs/ref/contrib/postgres/search.txt index f00bddbee4..fe4e86f05e 100644 --- a/docs/ref/contrib/postgres/search.txt +++ b/docs/ref/contrib/postgres/search.txt @@ -35,10 +35,6 @@ query and the vector. To use the ``search`` lookup, ``'django.contrib.postgres'`` must be in your :setting:`INSTALLED_APPS`. -.. versionchanged:: 3.1 - - Support for query expressions was added. - ``SearchVector`` ================ @@ -110,11 +106,6 @@ Examples: See :ref:`postgresql-fts-search-configuration` for an explanation of the ``config`` parameter. -.. versionchanged:: 3.1 - - Support for ``'websearch'`` search type and query expressions in - ``SearchQuery.value`` were added. - ``SearchRank`` ============== @@ -159,15 +150,9 @@ normalization options`_. .. _different rank normalization options: https://www.postgresql.org/docs/current/textsearch-controls.html#TEXTSEARCH-RANKING -.. versionadded:: 3.1 - - The ``normalization`` and ``cover_density`` parameters were added. - ``SearchHeadline`` ================== -.. versionadded:: 3.1 - .. class:: SearchHeadline(expression, query, config=None, start_sel=None, stop_sel=None, max_words=None, min_words=None, short_word=None, highlight_all=None, max_fragments=None, fragment_delimiter=None) Accepts a single text field or an expression, a query, a config, and a set of diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index c916ff96c8..b7f6e175be 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -106,8 +106,6 @@ For example, to perform only models and compatibility checks, run:: .. django-admin-option:: --database DATABASE -.. versionadded:: 3.1 - Specifies the database to run checks requiring database access:: django-admin check --database default --database other @@ -226,8 +224,6 @@ Specifies the database onto which to open a shell. Defaults to ``default``. .. django-admin-option:: -- ARGUMENTS -.. versionadded:: 3.1 - Any arguments following a ``--`` divider will be passed on to the underlying command-line client. For example, with PostgreSQL you can use the ``psql`` command's ``-c`` flag to execute a raw SQL query directly: @@ -914,8 +910,6 @@ content types. .. django-admin-option:: --check -.. versionadded:: 3.1 - Makes ``migrate`` exit with a non-zero status when unapplied migrations are detected. @@ -1519,8 +1513,6 @@ installed, ``ipdb`` is used instead. .. django-admin-option:: --buffer, -b -.. versionadded:: 3.1 - Discards output (``stdout`` and ``stderr``) for passing tests, in the same way as :option:`unittest's --buffer option<unittest.-b>`. @@ -1709,8 +1701,6 @@ Specifies the database to use. Defaults to ``default``. .. django-admin-option:: --include-stale-apps -.. versionadded:: 3.1 - Deletes stale content types including ones from previously installed apps that have been removed from :setting:`INSTALLED_APPS`. Defaults to ``False``. diff --git a/docs/ref/files/storage.txt b/docs/ref/files/storage.txt index bd595f36b9..8cae580767 100644 --- a/docs/ref/files/storage.txt +++ b/docs/ref/files/storage.txt @@ -69,11 +69,6 @@ The ``FileSystemStorage`` class time of the last metadata change, and on others (like Windows), it's the creation time of the file. -.. versionchanged:: 3.1 - - Support for :class:`pathlib.Path` was added to the - ``FileSystemStorage.save()`` method. - The ``Storage`` class ===================== diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt index 8bf8f3c9c1..5df969232a 100644 --- a/docs/ref/forms/api.txt +++ b/docs/ref/forms/api.txt @@ -974,8 +974,6 @@ Attributes of ``BoundField`` .. attribute:: BoundField.widget_type - .. versionadded:: 3.1 - Returns the lowercased class name of the wrapped field's widget, with any trailing ``input`` or ``widget`` removed. This may be used when building forms where the layout is dependent upon the widget type. For example:: diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt index 9438214a28..52ab59e626 100644 --- a/docs/ref/forms/fields.txt +++ b/docs/ref/forms/fields.txt @@ -514,14 +514,6 @@ For each field, we describe the default widget used if you don't specify ``DATE_INPUT_FORMATS`` keys if localization is enabled. See also :doc:`format localization </topics/i18n/formatting>`. - .. versionchanged:: 3.1 - - Support for ISO 8601 date string parsing (including optional timezone) - was added. - - The fallback on ``DATE_INPUT_FORMATS`` in the default ``input_formats`` - was added. - ``DecimalField`` ---------------- @@ -782,8 +774,6 @@ For each field, we describe the default widget used if you don't specify .. class:: JSONField(encoder=None, decoder=None, **kwargs) - .. versionadded:: 3.1 - A field which accepts JSON encoded data for a :class:`~django.db.models.JSONField`. @@ -1450,21 +1440,11 @@ customize the yielded 2-tuple choices. :attr:`ChoiceField.choices`. The first ``value`` element is a :class:`ModelChoiceIteratorValue` instance. - .. versionchanged:: 3.1 - - In older versions, the first ``value`` element in the choice tuple - is the ``field`` value itself, rather than a - ``ModelChoiceIteratorValue`` instance. In most cases this proxies - transparently but, if you need the ``field`` value itself, use the - :attr:`ModelChoiceIteratorValue.value` attribute instead. - ``ModelChoiceIteratorValue`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. class:: ModelChoiceIteratorValue(value, instance) - .. versionadded:: 3.1 - Two arguments are required: .. attribute:: value diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt index 9a19ab1436..dbcc9175d0 100644 --- a/docs/ref/forms/widgets.txt +++ b/docs/ref/forms/widgets.txt @@ -336,11 +336,6 @@ foundation for custom widgets. a hidden ``textarea`` element may want to always return ``False`` to avoid browser validation on the hidden field. - .. versionchanged:: 3.1 - - In older versions, ``True`` was returned for - :class:`~django.forms.FileInput` when ``initial`` was set. - ``MultiWidget`` --------------- @@ -372,10 +367,6 @@ foundation for custom widgets. >>> widget.render('name', ['john', 'paul']) '<input type="text" name="name" value="john"><input type="text" name="name_last" value="paul">' - .. versionchanged::3.1 - - Support for using a dictionary was added. - And one required method: .. method:: decompress(value) diff --git a/docs/ref/models/constraints.txt b/docs/ref/models/constraints.txt index 1536a8692a..e3b682d1c5 100644 --- a/docs/ref/models/constraints.txt +++ b/docs/ref/models/constraints.txt @@ -58,10 +58,6 @@ specifies the check you want the constraint to enforce. For example, ``CheckConstraint(check=Q(age__gte=18), name='age_gte_18')`` ensures the age field is never less than 18. -.. versionchanged:: 3.1 - - Support for boolean :class:`~django.db.models.Expression` was added. - ``name`` -------- @@ -119,8 +115,6 @@ These conditions have the same database restrictions as .. attribute:: UniqueConstraint.deferrable -.. versionadded:: 3.1 - Set this parameter to create a deferrable unique constraint. Accepted values are ``Deferrable.DEFERRED`` or ``Deferrable.IMMEDIATE``. For example:: diff --git a/docs/ref/models/database-functions.txt b/docs/ref/models/database-functions.txt index 948ce4e3cc..b63b4cff4a 100644 --- a/docs/ref/models/database-functions.txt +++ b/docs/ref/models/database-functions.txt @@ -336,8 +336,6 @@ Usage example:: .. class:: ExtractIsoWeekDay(expression, tzinfo=None, **extra) - .. versionadded:: 3.1 - Returns the ISO-8601 week day with day 1 being Monday and day 7 being Sunday. diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index a315402347..3409d2d023 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -842,10 +842,6 @@ Has two optional arguments: handles the storage and retrieval of your files. See :doc:`/topics/files` for details on how to provide this object. - .. versionchanged:: 3.1 - - The ability to provide a callable was added. - The default form widget for this field is a :class:`~django.forms.ClearableFileInput`. @@ -1198,8 +1194,6 @@ values are stored as null. .. class:: JSONField(encoder=None, decoder=None, **options) -.. versionadded:: 3.1 - A field for storing JSON encoded data. In Python the data is represented in its Python native format: dictionaries, lists, strings, numbers, booleans and ``None``. @@ -1276,8 +1270,6 @@ Like :class:`BooleanField` with ``null=True``. .. class:: PositiveBigIntegerField(**options) -.. versionadded:: 3.1 - Like a :class:`PositiveIntegerField`, but only allows values under a certain (database-dependent) point. Values from ``0`` to ``9223372036854775807`` are safe in all databases supported by Django. @@ -1579,8 +1571,6 @@ The possible values for :attr:`~ForeignKey.on_delete` are found in * .. attribute:: RESTRICT - .. versionadded:: 3.1 - Prevent deletion of the referenced object by raising :exc:`~django.db.models.RestrictedError` (a subclass of :exc:`django.db.IntegrityError`). Unlike :attr:`PROTECT`, deletion of the diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt index 4222979972..7586159061 100644 --- a/docs/ref/models/instances.txt +++ b/docs/ref/models/instances.txt @@ -803,11 +803,6 @@ For example:: >>> p.get_shirt_size_display() 'Large' -.. versionchanged:: 3.1 - - Support for :class:`~django.contrib.postgres.fields.ArrayField` and - :class:`~django.contrib.postgres.fields.RangeField` was added. - .. method:: Model.get_next_by_FOO(**kwargs) .. method:: Model.get_previous_by_FOO(**kwargs) diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index 656bf537ad..eca0caf6d6 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -834,10 +834,6 @@ object. If it's ``None``, Django uses the :ref:`current time zone ambiguous datetimes in daylight saving time. By default (when ``is_dst=None``), ``pytz`` raises an exception for such datetimes. -.. versionadded:: 3.1 - - The ``is_dst`` parameter was added. - .. _database-time-zone-definitions: .. note:: @@ -2216,10 +2212,6 @@ normally supports it). Returns ``objs`` as cast to a list, in the same order as provided. -.. versionchanged:: 3.1 - - Support for the fetching primary key attributes on MariaDB 10.5+ was added. - ``bulk_update()`` ~~~~~~~~~~~~~~~~~ @@ -2742,11 +2734,6 @@ adverse effects on your database. For example, the ``ANALYZE`` flag supported by MariaDB, MySQL 8.0.18+, and PostgreSQL could result in changes to data if there are triggers or if a function is called, even for a ``SELECT`` query. -.. versionchanged:: 3.1 - - Support for the ``'TREE'`` format on MySQL 8.0.16+ and ``analyze`` option - on MariaDB and MySQL 8.0.18+ were added. - .. _field-lookups: ``Field`` lookups @@ -3273,8 +3260,6 @@ in the database <database-time-zone-definitions>`. ``iso_week_day`` ~~~~~~~~~~~~~~~~ -.. versionadded:: 3.1 - For date and datetime fields, an exact ISO 8601 day of the week match. Allows chaining additional field lookups. diff --git a/docs/ref/models/relations.txt b/docs/ref/models/relations.txt index 1e81352c69..1c2591cc0c 100644 --- a/docs/ref/models/relations.txt +++ b/docs/ref/models/relations.txt @@ -75,10 +75,6 @@ Related objects reference dictionary and they will be evaluated once before creating any intermediate instance(s). - .. versionchanged:: 3.1 - - ``through_defaults`` values can now be callables. - .. method:: create(through_defaults=None, **kwargs) Creates a new object, saves it and puts it in the related object set. @@ -114,10 +110,6 @@ Related objects reference needed. You can use callables as values in the ``through_defaults`` dictionary. - .. versionchanged:: 3.1 - - ``through_defaults`` values can now be callables. - .. method:: remove(*objs, bulk=True) Removes the specified model objects from the related object set:: @@ -208,10 +200,6 @@ Related objects reference dictionary and they will be evaluated once before creating any intermediate instance(s). - .. versionchanged:: 3.1 - - ``through_defaults`` values can now be callables. - .. note:: Note that ``add()``, ``create()``, ``remove()``, ``clear()``, and diff --git a/docs/ref/paginator.txt b/docs/ref/paginator.txt index 4cc5483828..7758234d6e 100644 --- a/docs/ref/paginator.txt +++ b/docs/ref/paginator.txt @@ -17,10 +17,6 @@ classes live in :source:`django/core/paginator.py`. A paginator acts like a sequence of :class:`Page` when using ``len()`` or iterating it directly. - .. versionchanged:: 3.1 - - Support for iterating over ``Paginator`` was added. - .. attribute:: Paginator.object_list Required. A list, tuple, ``QuerySet``, or other sliceable object with a diff --git a/docs/ref/request-response.txt b/docs/ref/request-response.txt index 4528373b8c..819272bd6e 100644 --- a/docs/ref/request-response.txt +++ b/docs/ref/request-response.txt @@ -406,8 +406,6 @@ Methods .. method:: HttpRequest.accepts(mime_type) - .. versionadded:: 3.1 - Returns ``True`` if the request ``Accept`` header matches the ``mime_type`` argument:: @@ -911,10 +909,6 @@ Methods .. _HttpOnly: https://owasp.org/www-community/HttpOnly .. _SameSite: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite - .. versionchanged:: 3.1 - - Using ``samesite='None'`` (string) was allowed. - .. warning:: :rfc:`RFC 6265 <6265#section-6.1>` states that user agents should @@ -932,10 +926,6 @@ Methods you will need to remember to pass it to the corresponding :meth:`HttpRequest.get_signed_cookie` call. - .. versionchanged:: 3.1 - - Using ``samesite='None'`` (string) was allowed. - .. method:: HttpResponse.delete_cookie(key, path='/', domain=None, samesite=None) Deletes the cookie with the given key. Fails silently if the key doesn't @@ -945,10 +935,6 @@ Methods values you used in ``set_cookie()`` -- otherwise the cookie may not be deleted. - .. versionchanged:: 2.2.15 - - The ``samesite`` argument was added. - .. method:: HttpResponse.close() This method is called at the end of the request directly by the WSGI diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 5fdb76b2d0..55773d5c9b 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -99,11 +99,6 @@ This validation only applies via :meth:`~django.http.HttpRequest.get_host()`; if your code accesses the ``Host`` header directly from ``request.META`` you are bypassing this security protection. -.. versionchanged:: 3.1 - - If ``ALLOWED_HOSTS`` is empty and ``DEBUG=True``, subdomains of localhost - were allowed. - .. setting:: APPEND_SLASH ``APPEND_SLASH`` @@ -387,10 +382,6 @@ cookie from being sent in cross-site requests. See :setting:`SESSION_COOKIE_SAMESITE` for details about ``SameSite``. -.. versionchanged:: 3.1 - - Setting ``CSRF_COOKIE_SAMESITE = 'None'`` was allowed. - .. setting:: CSRF_COOKIE_SECURE ``CSRF_COOKIE_SECURE`` @@ -688,10 +679,6 @@ When :setting:`USE_TZ` is ``False``, it is an error to set this option. Consider converting to local time explicitly with ``AT TIME ZONE`` in raw SQL queries instead of setting the ``TIME_ZONE`` option. -.. versionchanged:: 3.1 - - Using this option when the database backend supports time zones was allowed. - .. setting:: DATABASE-DISABLE_SERVER_SIDE_CURSORS ``DISABLE_SERVER_SIDE_CURSORS`` @@ -786,8 +773,6 @@ on :ref:`controlling the creation order of test databases ``MIGRATE`` ^^^^^^^^^^^ -.. versionadded:: 3.1 - Default: ``True`` When set to ``False``, migrations won't run when creating the test database. @@ -1161,10 +1146,6 @@ precedence and will be applied instead. See also :setting:`DATE_INPUT_FORMATS` and :setting:`TIME_INPUT_FORMATS`. -.. versionchanged:: 3.1 - - In older versions, the default is a list containing also date-only formats. - .. setting:: DEBUG ``DEBUG`` @@ -1272,8 +1253,6 @@ manually specified. Used when constructing the ``Content-Type`` header. ``DEFAULT_EXCEPTION_REPORTER`` ------------------------------ -.. versionadded:: 3.1 - Default: ``'``:class:`django.views.debug.ExceptionReporter`\ ``'`` Default exception reporter class to be used if none has been assigned to the @@ -1317,8 +1296,6 @@ and :setting:`MANAGERS`; for that, see :setting:`SERVER_EMAIL`. ``DEFAULT_HASHING_ALGORITHM`` ----------------------------- -.. versionadded:: 3.1 - Default: ``'sha256'`` Default hashing algorithm to use for encoding cookies, password reset tokens in @@ -1385,10 +1362,6 @@ Default: Not defined The directory used by the :ref:`file email backend <topic-email-file-backend>` to store output files. -.. versionchanged:: 3.1 - - Support for :class:`pathlib.Path` was added. - .. setting:: EMAIL_HOST ``EMAIL_HOST`` @@ -1910,10 +1883,6 @@ cookie from being sent in cross-site requests. See :setting:`SESSION_COOKIE_SAMESITE` for details about ``SameSite``. -.. versionchanged:: 3.1 - - Setting ``LANGUAGE_COOKIE_SAMESITE = 'None'`` was allowed. - .. setting:: LANGUAGE_COOKIE_SECURE ``LANGUAGE_COOKIE_SECURE`` @@ -2422,10 +2391,6 @@ If configured, the :class:`~django.middleware.security.SecurityMiddleware` sets the :ref:`referrer-policy` header on all responses that do not already have it to the value provided. -.. versionchanged:: 3.1 - - In older versions, the default value is ``None``. - .. setting:: SECURE_SSL_HOST ``SECURE_SSL_HOST`` @@ -2986,8 +2951,6 @@ rendered. ``PASSWORD_RESET_TIMEOUT`` -------------------------- -.. versionadded:: 3.1 - Default: ``259200`` (3 days, in seconds) The number of seconds a password reset link is valid for. @@ -3267,10 +3230,6 @@ Possible values for the setting are: Modern browsers provide a more secure default policy for the ``SameSite`` flag and will assume ``Lax`` for cookies without an explicit value set. -.. versionchanged:: 3.1 - - Setting ``SESSION_COOKIE_SAMESITE = 'None'`` was allowed. - .. _SameSite: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite .. setting:: SESSION_COOKIE_SECURE diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index 02b63db248..d431a9bc42 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -729,10 +729,6 @@ available to the included template:: been evaluated and rendered* - not blocks that can be overridden by, for example, an extending template. -.. versionchanged:: 3.1 - - Support for iterables of template names was added. - .. templatetag:: load ``load`` @@ -1747,11 +1743,6 @@ example, when the active locale is ``en`` (English): Using ``floatformat`` with no argument is equivalent to using ``floatformat`` with an argument of ``-1``. -.. versionchanged:: 3.1 - - In older versions, a negative zero ``-0`` was returned for negative numbers - which round to zero. - .. versionchanged:: 3.2 The ``g`` suffix to force grouping by thousand separators was added. diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt index 921aba5de8..f88fc7f9e7 100644 --- a/docs/ref/utils.txt +++ b/docs/ref/utils.txt @@ -43,11 +43,6 @@ need to distinguish caches by the ``Accept-language`` header. * All other parameters are added with their value, after applying ``str()`` to it. - .. versionchanged:: 3.1 - - Support for multiple field names in the ``no-cache`` directive was - added. - .. function:: get_max_age(response) Returns the max-age from the response Cache-Control header as an integer @@ -131,10 +126,6 @@ The functions defined in this module share the following properties: UTC offsets aren't supported; if ``value`` describes one, the result is ``None``. - .. versionchanged:: 3.1 - - Support for comma separators for milliseconds was added. - .. function:: parse_datetime(value) Parses a string and returns a :class:`datetime.datetime`. @@ -142,10 +133,6 @@ The functions defined in this module share the following properties: UTC offsets are supported; if ``value`` describes one, the result's ``tzinfo`` attribute is a :class:`datetime.timezone` instance. - .. versionchanged:: 3.1 - - Support for comma separators for milliseconds was added. - .. function:: parse_duration(value) Parses a string and returns a :class:`datetime.timedelta`. @@ -155,11 +142,6 @@ The functions defined in this module share the following properties: ``P4DT1H15M20S`` which is equivalent to ``4 1:15:20``) or PostgreSQL's day-time interval format (e.g. ``3 days 04:05:06``). - .. versionchanged:: 3.1 - - Support for comma separators for decimal fractions in the ISO 8601 - format and for the format ``"DD HH:MM:SS,uuuuuu"`` was added. - ``django.utils.decorators`` =========================== @@ -204,24 +186,18 @@ The functions defined in this module share the following properties: .. function:: sync_only_middleware(middleware) - .. versionadded:: 3.1 - Marks a middleware as :ref:`synchronous-only <async-middleware>`. (The default in Django, but this allows you to future-proof if the default ever changes in a future release.) .. function:: async_only_middleware(middleware) - .. versionadded:: 3.1 - Marks a middleware as :ref:`asynchronous-only <async-middleware>`. Django will wrap it in an asynchronous event loop when it is called from the WSGI request path. .. function:: sync_and_async_middleware(middleware) - .. versionadded:: 3.1 - Marks a middleware as :ref:`sync and async compatible <async-middleware>`, this allows to avoid converting requests. You must implement detection of the current request type to use this decorator. See :ref:`asynchronous @@ -321,10 +297,6 @@ The functions defined in this module share the following properties: Returns an ASCII string containing the encoded result. - .. versionchanged:: 3.1 - - Support for :class:`pathlib.Path` ``path`` was added. - .. function:: escape_uri_path(path) Escapes the unsafe characters from the path portion of a Uniform Resource @@ -550,8 +522,6 @@ https://web.archive.org/web/20110718035220/http://diveintomark.org/archives/2004 .. class:: classproperty(method=None) - .. versionadded:: 3.1 - Similar to :py:func:`@classmethod <classmethod>`, the ``@classproperty`` decorator converts the result of a method with a single ``cls`` argument into a property that can be accessed directly from the class. |
