diff options
Diffstat (limited to 'docs/ref')
35 files changed, 43 insertions, 503 deletions
diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt index d73e830747..9029e55635 100644 --- a/docs/ref/applications.txt +++ b/docs/ref/applications.txt @@ -4,8 +4,6 @@ Applications .. module:: django.apps -.. versionadded:: 1.7 - Django contains a registry of installed applications that stores configuration and provides introspection. It also maintains a list of available :doc:`models </topics/db/models>`. diff --git a/docs/ref/checks.txt b/docs/ref/checks.txt index 03f280bd2e..f5b95da14c 100644 --- a/docs/ref/checks.txt +++ b/docs/ref/checks.txt @@ -2,8 +2,6 @@ System check framework ====================== -.. versionadded:: 1.7 - The system check framework is a set of static checks for validating Django projects. It detects common problems and provides hints for how to fix them. The framework is extensible so you can easily add your own checks. diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index 35813e936e..c7c2afb019 100644 --- a/docs/ref/contrib/admin/index.txt +++ b/docs/ref/contrib/admin/index.txt @@ -102,8 +102,6 @@ The register decorator .. function:: register(*models, [site=django.admin.sites.site]) - .. versionadded:: 1.7 - There is also a decorator for registering your ``ModelAdmin`` classes:: from django.contrib import admin @@ -134,15 +132,11 @@ application and imports it. .. class:: apps.AdminConfig - .. versionadded:: 1.7 - This is the default :class:`~django.apps.AppConfig` class for the admin. It calls :func:`~django.contrib.admin.autodiscover()` when Django starts. .. class:: apps.SimpleAdminConfig - .. versionadded:: 1.7 - This class works like :class:`~django.contrib.admin.apps.AdminConfig`, except it doesn't call :func:`~django.contrib.admin.autodiscover()`. @@ -151,12 +145,8 @@ application and imports it. This function attempts to import an ``admin`` module in each installed application. Such modules are expected to register models with the admin. - .. versionchanged:: 1.7 - - Previous versions of Django recommended calling this function directly - in the URLconf. As of Django 1.7 this isn't needed anymore. - :class:`~django.contrib.admin.apps.AdminConfig` takes care of running - the auto-discovery automatically. + Typically you won't need to call this function directly as + :class:`~django.contrib.admin.apps.AdminConfig` calls it when Django starts. If you are using a custom ``AdminSite``, it is common to import all of the ``ModelAdmin`` subclasses into your code and register them to the custom @@ -164,14 +154,6 @@ If you are using a custom ``AdminSite``, it is common to import all of the put ``'django.contrib.admin.apps.SimpleAdminConfig'`` instead of ``'django.contrib.admin'`` in your :setting:`INSTALLED_APPS` setting. -.. versionchanged:: 1.7 - - In previous versions, the admin needed to be instructed to look for - ``admin.py`` files with :func:`~django.contrib.admin.autodiscover()`. - As of Django 1.7, auto-discovery is enabled by default and must be - explicitly disabled when it's undesirable. - - ``ModelAdmin`` options ---------------------- @@ -661,8 +643,6 @@ subclass:: The above will tell Django to order by the ``first_name`` field when trying to sort by ``colored_first_name`` in the admin. - .. versionadded:: 1.7 - To indicate descending order with ``admin_order_field`` you can use a hyphen prefix on the field name. Using the above example, this would look like:: @@ -737,10 +717,6 @@ subclass:: list_display = ('timestamp', 'message') list_display_links = None - .. versionchanged:: 1.7 - - ``None`` was added as a valid ``list_display_links`` value. - .. _admin-list-editable: .. attribute:: ModelAdmin.list_editable @@ -1176,8 +1152,6 @@ subclass:: .. attribute:: ModelAdmin.view_on_site - .. versionadded:: 1.7 - Set ``view_on_site`` to control whether or not to display the "View on site" link. This link should bring you to a URL where you can display the saved object. @@ -1373,14 +1347,8 @@ templates used by the :class:`ModelAdmin` views: names on the changelist that will be linked to the change view, as described in the :attr:`ModelAdmin.list_display_links` section. - .. versionchanged:: 1.7 - - ``None`` was added as a valid ``get_list_display_links()`` return value. - .. method:: ModelAdmin.get_fields(request, obj=None) - .. versionadded:: 1.7 - The ``get_fields`` method is given the ``HttpRequest`` and the ``obj`` being edited (or ``None`` on an add form) and is expected to return a list of fields, as described above in the :attr:`ModelAdmin.fields` section. @@ -1400,8 +1368,6 @@ templates used by the :class:`ModelAdmin` views: .. method:: ModelAdmin.get_search_fields(request) - .. versionadded:: 1.7 - The ``get_search_fields`` method is given the ``HttpRequest`` and is expected to return the same kind of sequence type as for the :attr:`~ModelAdmin.search_fields` attribute. @@ -1723,8 +1689,6 @@ templates used by the :class:`ModelAdmin` views: .. method:: ModelAdmin.response_delete(request, obj_display, obj_id) - .. versionadded:: 1.7 - Determines the :class:`~django.http.HttpResponse` for the :meth:`delete_view` stage. @@ -1744,8 +1708,6 @@ templates used by the :class:`ModelAdmin` views: .. method:: ModelAdmin.get_changeform_initial_data(request) - .. versionadded:: 1.7 - A hook for the initial data on admin change forms. By default, fields are given initial values from ``GET`` parameters. For instance, ``?name=initial_value`` will set the ``name`` field's initial value to be @@ -2021,8 +1983,6 @@ The ``InlineModelAdmin`` class adds: .. attribute:: InlineModelAdmin.min_num - .. versionadded:: 1.7 - This controls the minimum number of forms to show in the inline. See :func:`~django.forms.models.modelformset_factory` for more information. @@ -2114,8 +2074,6 @@ The ``InlineModelAdmin`` class adds: .. method:: InlineModelAdmin.get_min_num(request, obj=None, **kwargs) - .. versionadded:: 1.7 - Returns the minimum number of inline forms to use. By default, returns the :attr:`InlineModelAdmin.min_num` attribute. @@ -2451,15 +2409,11 @@ Templates can override or extend base admin templates as described in .. attribute:: AdminSite.site_header - .. versionadded:: 1.7 - The text to put at the top of each admin page, as an ``<h1>`` (a string). By default, this is "Django administration". .. attribute:: AdminSite.site_title - .. versionadded:: 1.7 - The text to put at the end of each admin page's ``<title>`` (a string). By default, this is "Django site admin". @@ -2472,8 +2426,6 @@ Templates can override or extend base admin templates as described in .. attribute:: AdminSite.index_title - .. versionadded:: 1.7 - The text to put at the top of the admin index page (a string). By default, this is "Site administration". @@ -2514,8 +2466,6 @@ Templates can override or extend base admin templates as described in .. method:: AdminSite.each_context(request) - .. versionadded:: 1.7 - Returns a dictionary of variables to put in the template context for every page in the admin site. diff --git a/docs/ref/contrib/auth.txt b/docs/ref/contrib/auth.txt index 6435dbd89e..bf50e73d99 100644 --- a/docs/ref/contrib/auth.txt +++ b/docs/ref/contrib/auth.txt @@ -215,12 +215,8 @@ Methods .. method:: email_user(subject, message, from_email=None, **kwargs) Sends an email to the user. If ``from_email`` is ``None``, Django uses - the :setting:`DEFAULT_FROM_EMAIL`. - - .. versionchanged:: 1.7 - - Any ``**kwargs`` are passed to the underlying - :meth:`~django.core.mail.send_mail()` call. + the :setting:`DEFAULT_FROM_EMAIL`. Any ``**kwargs`` are passed to the + underlying :meth:`~django.core.mail.send_mail()` call. Manager methods --------------- diff --git a/docs/ref/contrib/contenttypes.txt b/docs/ref/contrib/contenttypes.txt index e4b2517822..f741e30a37 100644 --- a/docs/ref/contrib/contenttypes.txt +++ b/docs/ref/contrib/contenttypes.txt @@ -366,8 +366,6 @@ Reverse generic relations .. attribute:: related_query_name - .. versionadded:: 1.7 - The relation on the related object back to this object doesn't exist by default. Setting ``related_query_name`` creates a relation from the related object back to this one. This allows querying and filtering @@ -392,8 +390,6 @@ be used to retrieve their associated ``TaggedItems``:: >>> b.tags.all() [<TaggedItem: django>, <TaggedItem: python>] -.. versionadded:: 1.7 - Defining :class:`~django.contrib.contenttypes.fields.GenericRelation` with ``related_query_name`` set allows querying from the related object:: @@ -502,15 +498,10 @@ The :mod:`django.contrib.contenttypes.forms` module provides: :class:`~django.contrib.contenttypes.fields.GenericForeignKey.for_concrete_model` argument on ``GenericForeignKey``. - .. versionchanged:: 1.7 - - ``min_num`` and ``validate_min`` were added. - - .. module:: django.contrib.contenttypes.admin Generic relations in admin ------------------------------------- +-------------------------- The :mod:`django.contrib.contenttypes.admin` module provides :class:`~django.contrib.contenttypes.admin.GenericTabularInline` and diff --git a/docs/ref/contrib/gis/geos.txt b/docs/ref/contrib/gis/geos.txt index 3be3af7bba..f788bfff00 100644 --- a/docs/ref/contrib/gis/geos.txt +++ b/docs/ref/contrib/gis/geos.txt @@ -737,16 +737,12 @@ For example:: .. method:: crosses(other) - .. versionadded:: 1.7 - .. note:: GEOS 3.3 is *required* to use this predicate. .. method:: disjoint(other) - .. versionadded:: 1.7 - .. note:: GEOS 3.3 is *required* to use this predicate. @@ -755,24 +751,18 @@ For example:: .. method:: overlaps(other) - .. versionadded:: 1.7 - .. note:: GEOS 3.3 is *required* to use this predicate. .. method:: touches(other) - .. versionadded:: 1.7 - .. note:: GEOS 3.3 is *required* to use this predicate. .. method:: within(other) - .. versionadded:: 1.7 - .. note:: GEOS 3.3 is *required* to use this predicate. diff --git a/docs/ref/contrib/messages.txt b/docs/ref/contrib/messages.txt index fae6669d75..aaa2c26a45 100644 --- a/docs/ref/contrib/messages.txt +++ b/docs/ref/contrib/messages.txt @@ -198,8 +198,6 @@ Even if you know there is only just one message, you should still iterate over the ``messages`` sequence, because otherwise the message storage will not be cleared for the next request. -.. versionadded:: 1.7 - The context processor also provides a ``DEFAULT_MESSAGE_LEVELS`` variable which is a mapping of the message level names to their numeric value:: @@ -214,8 +212,6 @@ is a mapping of the message level names to their numeric value:: </ul> {% endif %} - - **Outside of templates**, you can use :func:`~django.contrib.messages.get_messages`:: @@ -253,8 +249,6 @@ The ``Message`` class * ``extra_tags``: A string containing custom tags for this message, separated by spaces. It's empty by default. - .. versionadded:: 1.7 - * ``level_tag``: The string representation of the level. By default, it's the lowercase version of the name of the associated constant, but this can be changed if you need by using the :setting:`MESSAGE_TAGS` setting. @@ -438,8 +432,6 @@ behavior: * :setting:`MESSAGE_STORAGE` * :setting:`MESSAGE_TAGS` -.. versionadded:: 1.7 - For backends that use cookies, the settings for the cookie are taken from the session cookie settings: diff --git a/docs/ref/contrib/redirects.txt b/docs/ref/contrib/redirects.txt index 80f0f3bc90..2aadf8a45c 100644 --- a/docs/ref/contrib/redirects.txt +++ b/docs/ref/contrib/redirects.txt @@ -89,20 +89,14 @@ Middleware .. attribute:: response_gone_class - .. versionadded:: 1.7 - The :class:`~django.http.HttpResponse` class used when a - :class:`~django.contrib.redirects.models.Redirect` is not - found for the requested path or has a blank ``new_path`` - value. + :class:`~django.contrib.redirects.models.Redirect` is not found for the + requested path or has a blank ``new_path`` value. Defaults to :class:`~django.http.HttpResponseGone`. .. attribute:: response_redirect_class - .. versionadded:: 1.7 - - The :class:`~django.http.HttpResponse` class that handles the - redirect. + The :class:`~django.http.HttpResponse` class that handles the redirect. Defaults to :class:`~django.http.HttpResponsePermanentRedirect`. diff --git a/docs/ref/contrib/sitemaps.txt b/docs/ref/contrib/sitemaps.txt index cb64685127..29623b0602 100644 --- a/docs/ref/contrib/sitemaps.txt +++ b/docs/ref/contrib/sitemaps.txt @@ -181,8 +181,6 @@ Sitemap class reference representing the last-modified date/time for *every* object returned by :attr:`~Sitemap.items()`. - .. versionadded:: 1.7 - If all items in a sitemap have a :attr:`~Sitemap.lastmod`, the sitemap generated by :func:`views.sitemap` will have a ``Last-Modified`` header equal to the latest ``lastmod``. You can activate the diff --git a/docs/ref/contrib/sites.txt b/docs/ref/contrib/sites.txt index 7ec8d00073..8c71ca0572 100644 --- a/docs/ref/contrib/sites.txt +++ b/docs/ref/contrib/sites.txt @@ -389,8 +389,6 @@ define :class:`~django.contrib.sites.managers.CurrentSiteManager`. Site middleware =============== -.. versionadded:: 1.7 - If you often use this pattern:: from django.contrib.sites.models import Site diff --git a/docs/ref/contrib/staticfiles.txt b/docs/ref/contrib/staticfiles.txt index 57f35877d7..6a365c6a44 100644 --- a/docs/ref/contrib/staticfiles.txt +++ b/docs/ref/contrib/staticfiles.txt @@ -78,13 +78,6 @@ respectively. For example:: Then set the :setting:`STATICFILES_STORAGE` setting to ``'path.to.MyStaticFilesStorage'``. -.. versionadded:: 1.7 - - The ability to override ``file_permissions_mode`` and - ``directory_permissions_mode`` is new in Django 1.7. Previously the file - permissions always used :setting:`FILE_UPLOAD_PERMISSIONS` and the directory - permissions always used :setting:`FILE_UPLOAD_DIRECTORY_PERMISSIONS`. - .. highlight:: console Some commonly used options are: @@ -174,10 +167,6 @@ get all the directories which were searched:: /home/polls.com/core/static /some/other/path/static -.. versionadded:: 1.7 - - The additional output of which directories were searched was added. - .. _staticfiles-runserver: runserver @@ -244,8 +233,6 @@ counterparts and update the cache appropriately. ManifestStaticFilesStorage -------------------------- -.. versionadded:: 1.7 - .. class:: storage.ManifestStaticFilesStorage A subclass of the :class:`~django.contrib.staticfiles.storage.StaticFilesStorage` @@ -370,10 +357,6 @@ of directory paths in which the finders searched. Example usage:: result = finders.find('css/base.css') searched_locations = finders.searched_locations -.. versionadded:: 1.7 - -The ``searched_locations`` attribute was added. - Other Helpers ============= @@ -423,12 +406,6 @@ This view function serves static files in development. **insecure**. This is only intended for local development, and should **never be used in production**. -.. versionchanged:: 1.7 - - This view will now raise an :exc:`~django.http.Http404` exception instead - of :exc:`~django.core.exceptions.ImproperlyConfigured` when - :setting:`DEBUG` is ``False``. - .. note:: To guess the served files' content types, this view relies on the @@ -502,8 +479,3 @@ But given the fact that it makes use of the transparently overlay at test execution-time the assets provided by the ``staticfiles`` finders. This means you don't need to run :djadmin:`collectstatic` before or as a part of your tests setup. - -.. versionadded:: 1.7 - - ``StaticLiveServerTestCase`` is new in Django 1.7. Previously its - functionality was provided by :class:`django.test.LiveServerTestCase`. diff --git a/docs/ref/contrib/syndication.txt b/docs/ref/contrib/syndication.txt index 879a45fbe9..39b6bb3bf0 100644 --- a/docs/ref/contrib/syndication.txt +++ b/docs/ref/contrib/syndication.txt @@ -954,10 +954,6 @@ They share this interface: :class:`django.utils.feedgenerator.Enclosure`. * ``categories`` should be a sequence of Unicode objects. - .. versionadded:: 1.7 - - The optional ``updateddate`` argument was added. - :meth:`.SyndicationFeed.write` Outputs the feed in the given encoding to outfile, which is a file-like object. diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index d894057748..ed7bd79626 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -5,11 +5,6 @@ django-admin and manage.py ``django-admin`` is Django's command-line utility for administrative tasks. This document outlines all it can do. -.. versionchanged:: 1.7 - - Prior to Django 1.7, ``django-admin`` was only installed as - ``django-admin.py``. - In addition, ``manage.py`` is automatically created in each Django project. ``manage.py`` is a thin wrapper around ``django-admin`` that takes care of several things for you before delegating to ``django-admin``: @@ -21,10 +16,6 @@ several things for you before delegating to ``django-admin``: * It calls :func:`django.setup()` to initialize various internals of Django. -.. versionadded:: 1.7 - - :func:`django.setup()` didn't exist in previous versions of Django. - The ``django-admin`` script should be on your system path if you installed Django via its ``setup.py`` utility. If it's not on your path, you can find it in ``site-packages/django/bin`` within your Python installation. Consider @@ -105,8 +96,6 @@ check <appname appname ...> .. django-admin:: check -.. versionchanged:: 1.7 - Uses the :doc:`system check framework </ref/checks>` to inspect the entire Django project for common problems. @@ -192,18 +181,13 @@ createcachetable .. django-admin:: createcachetable -Creates the cache tables for use with the database cache backend. See -:doc:`/topics/cache` for more information. +Creates the cache tables for use with the database cache backend using the +information from your settings file. See :doc:`/topics/cache` for more +information. The :djadminopt:`--database` option can be used to specify the database -onto which the cachetable will be installed. - -.. versionchanged:: 1.7 - - It is no longer necessary to provide the cache table name or the - :djadminopt:`--database` option. Django takes this information from your - settings file. If you have configured multiple caches or multiple databases, - all cache tables are created. +onto which the cache table will be installed, but since this information is +pulled from your settings by default, it's typically not needed. dbshell ------- @@ -286,8 +270,6 @@ from which data will be dumped. .. django-admin-option:: --natural-foreign -.. versionadded:: 1.7 - When this option is specified, Django will use the ``natural_key()`` model method to serialize any foreign key and many-to-many relationship to objects of the type that defines the method. If you are dumping ``contrib.auth`` @@ -298,8 +280,6 @@ and the next option. .. django-admin-option:: --natural-primary -.. versionadded:: 1.7 - When this option is specified, Django will not provide the primary key in the serialized data of this object since it can be calculated during deserialization. @@ -415,10 +395,6 @@ models that may have been removed since the fixture was originally generated. The :djadminopt:`--app` option can be used to specify a single app to look for fixtures in rather than looking through all apps. -.. versionchanged:: 1.7 - - ``--app`` was added. - .. versionchanged:: 1.8 ``--ignorenonexistent`` also ignores non-existent models. @@ -605,12 +581,6 @@ Example usage:: django-admin makemessages -x pt_BR django-admin makemessages -x pt_BR -x fr - -.. versionchanged:: 1.7 - - Added the ``--previous`` option to the ``msgmerge`` command when merging - with existing po files. - .. django-admin-option:: --domain Use the ``--domain`` or ``-d`` option to change the domain of the messages files. @@ -671,8 +641,6 @@ makemigrations [<app_label>] .. django-admin:: makemigrations -.. versionadded:: 1.7 - Creates new migrations based on the changes detected to your models. Migrations, their relationship with apps and more are covered in depth in :doc:`the migrations documentation</topics/migrations>`. @@ -722,8 +690,6 @@ migrate [<app_label> [<migrationname>]] .. django-admin:: migrate -.. versionadded:: 1.7 - Synchronizes the database state with the current set of models and migrations. Migrations, their relationship with apps and more are covered in depth in :doc:`the migrations documentation</topics/migrations>`. @@ -788,10 +754,6 @@ needed. You don't need to restart the server for code changes to take effect. However, some actions like adding files don't trigger a restart, so you'll have to restart the server in these cases. -.. versionchanged:: 1.7 - - Compiling translation files now also restarts the development server. - If you are using Linux and install `pyinotify`_, kernel signals will be used to autoreload the server (rather than polling file modification timestamps each second). This offers better scaling to large projects, reduction in response @@ -800,10 +762,6 @@ reduction. .. _pyinotify: https://pypi.python.org/pypi/pyinotify/ -.. versionadded:: 1.7 - - ``pyinotify`` support was added. - When you start the server, and each time you change Python code while the server is running, the server will check your entire Django project for errors (see the :djadmin:`check` command). If any errors are found, they will be printed @@ -1468,8 +1426,6 @@ that ``django-admin`` should print to the console. .. django-admin-option:: --no-color -.. versionadded:: 1.7 - Example usage:: django-admin sqlall --no-color @@ -1620,12 +1576,6 @@ would specify the use of all the colors in the light color palette, *except* for the colors for errors and notices which would be overridden as specified. -.. versionadded:: 1.7 - -Support for color-coded output from ``django-admin`` / ``manage.py`` -utilities on Windows by relying on the ANSICON application was added in Django -1.7. - .. _ANSICON: http://adoxa.altervista.org/ansicon/ Bash completion @@ -1641,10 +1591,8 @@ distribution. It enables tab-completion of ``django-admin`` and * Type ``sql``, then [TAB], to see all available options whose names start with ``sql``. - See :doc:`/howto/custom-management-commands` for how to add customized actions. - ========================================== Running management commands from your code ========================================== diff --git a/docs/ref/files/storage.txt b/docs/ref/files/storage.txt index 88da416dcf..ad5616c0dd 100644 --- a/docs/ref/files/storage.txt +++ b/docs/ref/files/storage.txt @@ -51,22 +51,11 @@ The FileSystemStorage Class The file system permissions that the file will receive when it is saved. Defaults to :setting:`FILE_UPLOAD_PERMISSIONS`. - .. versionadded:: 1.7 - - The ``file_permissions_mode`` attribute was added. Previously files - always received :setting:`FILE_UPLOAD_PERMISSIONS` permissions. - .. attribute:: directory_permissions_mode The file system permissions that the directory will receive when it is saved. Defaults to :setting:`FILE_UPLOAD_DIRECTORY_PERMISSIONS`. - .. versionadded:: 1.7 - - The ``directory_permissions_mode`` attribute was added. Previously - directories always received - :setting:`FILE_UPLOAD_DIRECTORY_PERMISSIONS` permissions. - .. note:: The ``FileSystemStorage.delete()`` method will not raise @@ -129,15 +118,6 @@ The Storage Class 7 character alphanumeric string is appended to the filename before the extension. - .. versionchanged:: 1.7 - - Previously, an underscore followed by a number (e.g. ``"_1"``, - ``"_2"``, etc.) was appended to the filename until an available - name in the destination directory was found. A malicious user could - exploit this deterministic algorithm to create a denial-of-service - attack. This change was also made in Django 1.6.6, 1.5.9, and - 1.4.14. - .. versionchanged:: 1.8 The ``max_length`` argument was added. diff --git a/docs/ref/files/uploads.txt b/docs/ref/files/uploads.txt index 5746985911..bb2bbad321 100644 --- a/docs/ref/files/uploads.txt +++ b/docs/ref/files/uploads.txt @@ -57,8 +57,6 @@ Here are some useful attributes of ``UploadedFile``: .. attribute:: UploadedFile.content_type_extra - .. versionadded:: 1.7 - A dictionary containing extra parameters passed to the ``content-type`` header. This is typically provided by services, such as Google App Engine, that intercept and handle file uploads on your behalf. As a result your @@ -220,10 +218,6 @@ attributes: This method may raise a ``StopFutureHandlers`` exception to prevent future handlers from handling this file. - .. versionadded:: 1.7 - - The ``content_type_extra`` parameter was added. - .. method:: FileUploadHandler.upload_complete() Callback signaling that the entire upload (all files) has completed. diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt index 44987ab98c..ec50f02d42 100644 --- a/docs/ref/forms/api.txt +++ b/docs/ref/forms/api.txt @@ -125,8 +125,6 @@ if validation has side effects, those side effects will only be triggered once. .. method:: Form.errors.as_data() -.. versionadded:: 1.7 - Returns a ``dict`` that maps fields to their original ``ValidationError`` instances. @@ -150,8 +148,6 @@ messages in ``Form.errors``. .. method:: Form.errors.as_json(escape_html=False) -.. versionadded:: 1.7 - Returns the errors serialized as JSON. >>> f.errors.as_json() @@ -171,8 +167,6 @@ directly in HTML. .. method:: Form.add_error(field, error) -.. versionadded:: 1.7 - This method allows adding errors to specific fields from within the ``Form.clean()`` method, or from outside the form altogether; for instance from a view. @@ -762,10 +756,6 @@ Python 2):: <p>Sender: <input type="email" name="sender" value="invalid email address" /></p> <p>Cc myself: <input checked="checked" type="checkbox" name="cc_myself" /></p> -.. versionchanged:: 1.7 - - ``django.forms.util`` was renamed to ``django.forms.utils``. - More granular output ~~~~~~~~~~~~~~~~~~~~ @@ -1017,10 +1007,8 @@ classes:: <li>Instrument: <input type="text" name="instrument" /></li> <li>Haircut type: <input type="text" name="haircut_type" /></li> -.. versionadded:: 1.7 - -* It's possible to declaratively remove a ``Field`` inherited from a parent - class by setting the name to be ``None`` on the subclass. For example:: +It's possible to declaratively remove a ``Field`` inherited from a parent class +by setting the name to be ``None`` on the subclass. For example:: >>> from django import forms diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt index 0a80a3c9f3..c25fe5533d 100644 --- a/docs/ref/forms/fields.txt +++ b/docs/ref/forms/fields.txt @@ -970,8 +970,6 @@ Slightly complex built-in ``Field`` classes .. attribute:: require_all_fields - .. versionadded:: 1.7 - Defaults to ``True``, in which case a ``required`` validation error will be raised if no value is supplied for any field. diff --git a/docs/ref/forms/formsets.txt b/docs/ref/forms/formsets.txt index a4143e5de4..704a9bb198 100644 --- a/docs/ref/forms/formsets.txt +++ b/docs/ref/forms/formsets.txt @@ -13,7 +13,3 @@ Formset API reference. For introductory material about formsets, see the Returns a ``FormSet`` class for the given ``form`` class. See :ref:`formsets` for example usage. - - .. versionchanged:: 1.7 - - The ``min_num`` and ``validate_min`` parameters were added. diff --git a/docs/ref/forms/validation.txt b/docs/ref/forms/validation.txt index 5f57e1b8f0..26d69cfbae 100644 --- a/docs/ref/forms/validation.txt +++ b/docs/ref/forms/validation.txt @@ -179,8 +179,6 @@ to override your error message you can still opt for the less verbose:: ValidationError(_('Invalid value: %s') % value) -.. versionadded:: 1.7 - The :meth:`Form.errors.as_data() <django.forms.Form.errors.as_data()>` and :meth:`Form.errors.as_json() <django.forms.Form.errors.as_json()>` methods greatly benefit from fully featured ``ValidationError``\s (with a ``code`` name @@ -369,12 +367,6 @@ example:: raise forms.ValidationError("Did not send for 'help' in " "the subject despite CC'ing yourself.") -.. versionchanged:: 1.7 - - In previous versions of Django, ``form.clean()`` was required to return - a dictionary of ``cleaned_data``. This method may still return a dictionary - of data to be used, but it's no longer required. - In this code, if the validation error is raised, the form will display an error message at the top of the form (normally) describing the problem. diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt index 55b29c131e..2260986ee1 100644 --- a/docs/ref/forms/widgets.txt +++ b/docs/ref/forms/widgets.txt @@ -650,8 +650,6 @@ Selector and checkbox widgets The outer ``<ul>`` container will receive the ``id`` attribute defined on the widget. -.. versionchanged:: 1.7 - When looping over the radio buttons, the ``label`` and ``input`` tags include ``for`` and ``id`` attributes, respectively. Each radio button has an ``id_for_label`` attribute to output the element's ID. @@ -677,11 +675,9 @@ Selector and checkbox widgets Like :class:`RadioSelect`, you can now loop over the individual checkboxes making up the lists. See the documentation of :class:`RadioSelect` for more details. -.. versionchanged:: 1.7 - - When looping over the checkboxes, the ``label`` and ``input`` tags include - ``for`` and ``id`` attributes, respectively. Each checkbox has an - ``id_for_label`` attribute to output the element's ID. +When looping over the checkboxes, the ``label`` and ``input`` tags include +``for`` and ``id`` attributes, respectively. Each checkbox has an +``id_for_label`` attribute to output the element's ID. .. _file-upload-widgets: @@ -769,8 +765,6 @@ Composite widgets .. attribute:: SelectDateWidget.months - .. versionadded:: 1.7 - An optional dict of months to use in the "months" select box. The keys of the dict correspond to the month number (1-indexed) and diff --git a/docs/ref/middleware.txt b/docs/ref/middleware.txt index 8f3f3094e9..3088350f1f 100644 --- a/docs/ref/middleware.txt +++ b/docs/ref/middleware.txt @@ -354,8 +354,6 @@ Site middleware .. class:: CurrentSiteMiddleware -.. versionadded:: 1.7 - Adds the ``site`` attribute representing the current site to every incoming ``HttpRequest`` object. See the :ref:`sites documentation <site-middleware>`. @@ -378,8 +376,6 @@ Middleware for utilizing Web server provided authentication. See .. class:: SessionAuthenticationMiddleware -.. versionadded:: 1.7 - Allows a user's sessions to be invalidated when their password changes. See :ref:`session-invalidation-on-password-change` for details. This middleware must appear after :class:`django.contrib.auth.middleware.AuthenticationMiddleware` diff --git a/docs/ref/migration-operations.txt b/docs/ref/migration-operations.txt index 76e8cae8b8..a1d5d5c454 100644 --- a/docs/ref/migration-operations.txt +++ b/docs/ref/migration-operations.txt @@ -188,10 +188,6 @@ Note that not all changes are possible on all databases - for example, you cannot change a text-type field like ``models.TextField()`` into a number-type field like ``models.IntegerField()`` on most databases. -.. versionchanged:: 1.7.1 - - The ``preserve_default`` argument was added. - RenameField ----------- @@ -240,11 +236,6 @@ The optional ``hints`` argument will be passed as ``**hints`` to the routing decisions. See :ref:`topics-db-multi-db-hints` for more details on database hints. -.. versionchanged:: 1.7.1 - - If you want to include literal percent signs in a query without parameters - you don't need to double them anymore. - .. versionchanged:: 1.8 The ability to pass parameters to the ``sql`` and ``reverse_sql`` queries diff --git a/docs/ref/models/expressions.txt b/docs/ref/models/expressions.txt index b6b4000278..b925b25f6f 100644 --- a/docs/ref/models/expressions.txt +++ b/docs/ref/models/expressions.txt @@ -17,10 +17,6 @@ Django supports addition, subtraction, multiplication, division, modulo arithmetic, and the power operator on query expressions, using Python constants, variables, and even other expressions. -.. versionadded:: 1.7 - - Support for the power operator ``**`` was added. - Some examples ============= diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index 6068fe0f7c..01fcb1a4ed 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -156,8 +156,6 @@ This lets you construct choices dynamically. But if you find yourself hacking database table with a :class:`ForeignKey`. :attr:`~Field.choices` is meant for static data that doesn't change much, if ever. -.. versionadded:: 1.7 - Unless :attr:`blank=False<Field.blank>` is set on the field along with a :attr:`~Field.default` then a label containing ``"---------"`` will be rendered with the select box. To override this behavior, add a tuple to ``choices`` @@ -241,10 +239,6 @@ Error message keys include ``null``, ``blank``, ``invalid``, ``invalid_choice``, ``unique``, and ``unique_for_date``. Additional error message keys are specified for each field in the `Field types`_ section below. -.. versionadded:: 1.7 - -The ``unique_for_date`` error message key was added. - ``help_text`` ------------- @@ -592,10 +586,6 @@ Has two optional arguments: .. attribute:: FileField.upload_to - .. versionchanged:: 1.7 - - ``upload_to`` was required in older versions of Django. - A local filesystem path that will be appended to your :setting:`MEDIA_ROOT` setting to determine the value of the :attr:`~django.db.models.fields.files.FieldFile.url` attribute. @@ -987,12 +977,10 @@ databases supported by Django. A large text field. The default form widget for this field is a :class:`~django.forms.Textarea`. -.. versionchanged:: 1.7 - - If you specify a ``max_length`` attribute, it will be reflected in the - :class:`~django.forms.Textarea` widget of the auto-generated form field. - However it is not enforced at the model or database level. Use a - :class:`CharField` for that. +If you specify a ``max_length`` attribute, it will be reflected in the +:class:`~django.forms.Textarea` widget of the auto-generated form field. +However it is not enforced at the model or database level. Use a +:class:`CharField` for that. .. admonition:: MySQL users @@ -1156,11 +1144,6 @@ define the details of how the relation works. :attr:`~django.contrib.admin.ModelAdmin.raw_id_fields` in the ``ModelAdmin`` for the model. - .. versionchanged:: 1.7 - - Previous versions of Django do not allow passing a callable as a value - for ``limit_choices_to``. - .. note:: If a callable is used for ``limit_choices_to``, it will be invoked @@ -1280,8 +1263,6 @@ The possible values for :attr:`~ForeignKey.on_delete` are found in .. attribute:: ForeignKey.swappable - .. versionadded:: 1.7 - Controls the migration framework's reaction if this :class:`ForeignKey` is pointing at a swappable model. If it is ``True`` - the default - then if the :class:`ForeignKey` is pointing at a model which matches @@ -1400,8 +1381,6 @@ that control how the relationship functions. .. attribute:: ManyToManyField.through_fields - .. versionadded:: 1.7 - Only used when a custom intermediary model is specified. Django will normally determine which fields of the intermediary model to use in order to establish a many-to-many relationship automatically. However, @@ -1470,8 +1449,6 @@ that control how the relationship functions. .. attribute:: ManyToManyField.swappable - .. versionadded:: 1.7 - Controls the migration framework's reaction if this :class:`ManyToManyField` is pointing at a swappable model. If it is ``True`` - the default - then if the :class:`ManyToManyField` is pointing at a model which matches @@ -1699,8 +1676,6 @@ Field API reference ``"year"``, ``"month"``, ``"day"``, ``"isnull"``, ``"search"``, ``"regex"``, and ``"iregex"``. - .. versionadded:: 1.7 - If you are using :doc:`Custom lookups </ref/models/lookups>` the ``lookup_type`` can be any ``lookup_name`` registered in the field. @@ -1752,8 +1727,6 @@ Field API reference .. method:: deconstruct() - .. versionadded:: 1.7 - Returns a 4-tuple with enough information to recreate the field: 1. The name of the field on the model. diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt index c294704641..8f55104357 100644 --- a/docs/ref/models/instances.txt +++ b/docs/ref/models/instances.txt @@ -683,11 +683,6 @@ For example:: MyModel(id=1) != MultitableInherited(id=1) MyModel(id=1) != MyModel(id=2) -.. versionchanged:: 1.7 - - In previous versions only instances of the exact same class and same - primary key value were considered equal. - ``__hash__`` ------------ @@ -700,11 +695,6 @@ method would return different values before and after the instance is saved, but changing the ``__hash__`` value of an instance `is forbidden in Python`_). -.. versionchanged:: 1.7 - - In previous versions instance's without primary key value were - hashable. - .. _is forbidden in Python: https://docs.python.org/reference/datamodel.html#object.__hash__ ``get_absolute_url`` diff --git a/docs/ref/models/lookups.txt b/docs/ref/models/lookups.txt index 23980eddc5..60dc505ed8 100644 --- a/docs/ref/models/lookups.txt +++ b/docs/ref/models/lookups.txt @@ -7,8 +7,6 @@ Lookup API reference .. currentmodule:: django.db.models -.. versionadded:: 1.7 - This document has the API references of lookups, the Django API for building the ``WHERE`` clause of a database query. To learn how to *use* lookups, see :doc:`/topics/db/queries`; to learn how to *create* new lookups, see diff --git a/docs/ref/models/options.txt b/docs/ref/models/options.txt index 1bd32f6192..5fd363f0d9 100644 --- a/docs/ref/models/options.txt +++ b/docs/ref/models/options.txt @@ -24,17 +24,12 @@ Available ``Meta`` options .. attribute:: Options.app_label - If a model exists outside of the standard locations (:file:`models.py` or - a ``models`` package in an app), the model must define which app it is part - of:: + If a model exists outside of an application in :setting:`INSTALLED_APPS` or + if it's imported before its application was loaded, it must define which + app it is part of:: app_label = 'myapp' - .. versionadded:: 1.7 - - ``app_label`` is no longer required for models that are defined - outside the ``models`` module of an application. - ``db_table`` ------------ @@ -275,8 +270,6 @@ Django quotes column and table names behind the scenes. .. attribute:: Options.default_permissions - .. versionadded:: 1.7 - Defaults to ``('add', 'change', 'delete')``. You may customize this list, for example, by setting this to an empty list if your app doesn't require any of the default permissions. It must be specified on the model before @@ -336,10 +329,8 @@ Django quotes column and table names behind the scenes. :class:`~django.db.models.ManyToManyField`, try using a signal or an explicit :attr:`through <ManyToManyField.through>` model. - .. versionchanged:: 1.7 - - The ``ValidationError`` raised during model validation when the - constraint is violated has the ``unique_together`` error code. + The ``ValidationError`` raised during model validation when the constraint + is violated has the ``unique_together`` error code. ``index_together`` ------------------ @@ -355,8 +346,6 @@ Django quotes column and table names behind the scenes. This list of fields will be indexed together (i.e. the appropriate ``CREATE INDEX`` statement will be issued.) - .. versionchanged:: 1.7 - For convenience, ``index_together`` can be a single list when dealing with a single set of fields:: diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index e304ca1416..c54fa6d014 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -329,11 +329,6 @@ the cost of a JOIN, by referring to the ``_id`` of the related field:: # Join Entry.objects.order_by('blog__id') -.. versionadded:: 1.7 - - The ability to order a queryset by a related field, without incurring - the cost of a JOIN was added. - You can also order by :doc:`query expressions </ref/models/expressions>` by calling ``asc()`` or ``desc()`` on the expression:: @@ -579,12 +574,6 @@ A few subtleties that are worth mentioning: * Calling :meth:`only()` and :meth:`defer()` after ``values()`` doesn't make sense, so doing so will raise a ``NotImplementedError``. -.. versionadded:: 1.7 - - The last point above is new. Previously, calling :meth:`only()` and - :meth:`defer()` after ``values()`` was allowed, but it either crashed or - returned incorrect results. - It is useful when you know you're only going to need values from a small number of the available fields and you won't need the functionality of a model instance object. It's more efficient to select only the fields you need to use. @@ -856,11 +845,6 @@ Chaining ``select_related`` calls works in a similar way to other methods - that is that ``select_related('foo', 'bar')`` is equivalent to ``select_related('foo').select_related('bar')``. -.. versionchanged:: 1.7 - - Previously the latter would have been equivalent to - ``select_related('bar')``. - prefetch_related ~~~~~~~~~~~~~~~~ @@ -1011,8 +995,6 @@ profile for your use case! Note that if you use ``iterator()`` to run the query, ``prefetch_related()`` calls will be ignored since these two optimizations do not make sense together. -.. versionadded:: 1.7 - You can use the :class:`~django.db.models.Prefetch` object to further control the prefetch operation. @@ -1483,11 +1465,6 @@ a transaction outside of one. Using ``select_for_update()`` on backends which do not support ``SELECT ... FOR UPDATE`` (such as SQLite) will have no effect. -.. versionchanged:: 1.6.3 - - It is now an error to execute a query with ``select_for_update()`` in - autocommit mode. With earlier releases in the 1.6 series it was a no-op. - .. warning:: Although ``select_for_update()`` normally fails in autocommit mode, since @@ -1503,11 +1480,6 @@ raw .. method:: raw(raw_query, params=None, translations=None) -.. versionchanged:: 1.7 - - ``raw`` was moved to the ``QuerySet`` class. It was previously only on - :class:`~django.db.models.Manager`. - Takes a raw SQL query, executes it, and returns a ``django.db.models.query.RawQuerySet`` instance. This ``RawQuerySet`` instance can be iterated over just like an normal ``QuerySet`` to provide object instances. @@ -1703,8 +1675,6 @@ update_or_create .. method:: update_or_create(defaults=None, **kwargs) -.. versionadded:: 1.7 - A convenience method for updating an object with the given ``kwargs``, creating a new one if necessary. The ``defaults`` is a dictionary of (field, value) pairs used to update the object. @@ -2119,8 +2089,6 @@ as_manager .. classmethod:: as_manager() -.. versionadded:: 1.7 - Class method that returns an instance of :class:`~django.db.models.Manager` with a copy of the ``QuerySet``’s methods. See :ref:`create-manager-with-queryset-methods` for more details. @@ -2175,12 +2143,9 @@ SQL equivalents:: iexact ~~~~~~ -Case-insensitive exact match. - -.. versionchanged:: 1.7 - - If the value provided for comparison is ``None``, it will be interpreted - as an SQL ``NULL`` (see :lookup:`isnull` for more details). +Case-insensitive exact match. If the value provided for comparison is ``None``, +it will be interpreted as an SQL ``NULL`` (see :lookup:`isnull` for more +details). Example:: @@ -2890,8 +2855,6 @@ in particular, it is not otherwise possible to use ``OR`` in ``QuerySets``. ``Prefetch()`` objects ---------------------- -.. versionadded:: 1.7 - .. class:: Prefetch(lookup, queryset=None, to_attr=None) The ``Prefetch()`` object can be used to control the operation of diff --git a/docs/ref/request-response.txt b/docs/ref/request-response.txt index ffe2bf4cd3..50310b9692 100644 --- a/docs/ref/request-response.txt +++ b/docs/ref/request-response.txt @@ -34,8 +34,6 @@ All attributes should be considered read-only, unless stated otherwise below. .. attribute:: HttpRequest.scheme - .. versionadded:: 1.7 - A string representing the scheme of the request (``http`` or ``https`` usually). @@ -865,8 +863,6 @@ types of HTTP responses. Like ``HttpResponse``, these subclasses live in JsonResponse objects ==================== -.. versionadded:: 1.7 - .. class:: JsonResponse .. method:: JsonResponse.__init__(data, encoder=DjangoJSONEncoder, safe=True, **kwargs) diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 5906cd3c9f..9570b81aac 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -40,11 +40,6 @@ a model object and return its URL. This is a way of inserting or overriding Note that the model name used in this setting should be all lower-case, regardless of the case of the actual model class name. -.. versionchanged:: 1.7.1 - - ``ABSOLUTE_URL_OVERRIDES`` now works on models that don't declare - ``get_absolute_url()``. - .. setting:: ADMINS ADMINS @@ -85,21 +80,9 @@ responsible to provide your own validation of the ``Host`` header (perhaps in a middleware; if so this middleware must be listed first in :setting:`MIDDLEWARE_CLASSES`). -.. versionchanged:: 1.7 - - In previous versions of Django, if you wanted to also allow the - `fully qualified domain name (FQDN)`_, which some browsers can send in the - ``Host`` header, you had to explicitly add another ``ALLOWED_HOSTS`` entry - that included a trailing period. This entry could also be a subdomain - wildcard:: - - ALLOWED_HOSTS = [ - '.example.com', # Allow domain and subdomains - '.example.com.', # Also allow FQDN and subdomains - ] - - In Django 1.7, the trailing dot is stripped when performing host validation, - thus an entry with a trailing dot isn't required. +Django also allows the `fully qualified domain name (FQDN)`_ of any entries. +Some browsers include a trailing dot in the ``Host`` header which Django +strips when performing host validation. .. _`fully qualified domain name (FQDN)`: http://en.wikipedia.org/wiki/Fully_qualified_domain_name @@ -270,11 +253,8 @@ TIMEOUT Default: 300 -The number of seconds before a cache entry is considered stale. - -.. versionadded:: 1.7 - -If the value of this settings is ``None``, cache entries will not expire. +The number of seconds before a cache entry is considered stale. If the value of +this settings is ``None``, cache entries will not expire. .. setting:: CACHES-VERSION @@ -329,8 +309,6 @@ See :doc:`/topics/cache`. CSRF_COOKIE_AGE --------------- -.. versionadded:: 1.7 - Default: ``31449600`` (1 year, in seconds) The age of CSRF cookies, in seconds. @@ -608,16 +586,6 @@ The username to use when connecting to the database. Not used with SQLite. TEST ~~~~ -.. versionchanged:: 1.7 - - All :setting:`TEST <DATABASE-TEST>` sub-entries used to be independent - entries in the database settings dictionary, with a ``TEST_`` prefix. - For backwards compatibility with older versions of Django, you can define - both versions of the settings as long as they match. - Further, ``TEST_CREATE``, ``TEST_USER_CREATE`` and ``TEST_PASSWD`` - were changed to ``CREATE_DB``, ``CREATE_USER`` and ``PASSWORD`` - respectively. - Default: ``{}`` A dictionary of settings for test databases; for more details about the @@ -703,8 +671,6 @@ See :ref:`the-test-database`. SERIALIZE ^^^^^^^^^ -.. versionadded:: 1.7.1 - Boolean value to control whether or not the default test runner serializes the database into an in-memory JSON string before running tests (used to restore the database state between tests if you don't have transactions). You can set @@ -1210,8 +1176,6 @@ experiencing hanging connections, see the implicit TLS setting EMAIL_USE_SSL ------------- -.. versionadded:: 1.7 - Default: ``False`` Whether to use an implicit TLS (secure) connection when talking to the SMTP @@ -1306,8 +1270,6 @@ the file system. See :doc:`/topics/files` for details. FILE_UPLOAD_DIRECTORY_PERMISSIONS --------------------------------- -.. versionadded:: 1.7 - Default: ``None`` The numeric mode to apply to directories created in the process of uploading @@ -1486,10 +1448,6 @@ Django installation. Each string should be a dotted Python path to: :doc:`Learn more about application configurations </ref/applications>`. -.. versionchanged:: 1.7 - - :setting:`INSTALLED_APPS` now supports application configurations. - .. admonition:: Use the application registry for introspection Your code should never access :setting:`INSTALLED_APPS` directly. Use @@ -1559,8 +1517,6 @@ See :ref:`how-django-discovers-language-preference` for more details. LANGUAGE_COOKIE_AGE ------------------- -.. versionadded:: 1.7 - Default: ``None`` (expires at browser close) The age of the language cookie, in seconds. @@ -1570,8 +1526,6 @@ The age of the language cookie, in seconds. LANGUAGE_COOKIE_DOMAIN ---------------------- -.. versionadded:: 1.7 - Default: ``None`` The domain to use for the language cookie. Set this to a string such as @@ -1604,8 +1558,6 @@ you want (but should be different from :setting:`SESSION_COOKIE_NAME`). See LANGUAGE_COOKIE_PATH -------------------- -.. versionadded:: 1.7 - Default: ``/`` The path set on the language cookie. This should either match the URL path of your @@ -1712,10 +1664,6 @@ configuration method by default. If you set :setting:`LOGGING_CONFIG` to ``None``, the logging configuration process will be skipped. -.. versionchanged:: 1.7 - - Previously, the default value was ``'django.utils.log.dictConfig'``. - .. _dictConfig: https://docs.python.org/library/logging.config.html#configuration-dictionary-schema .. setting:: MANAGERS @@ -1792,13 +1740,6 @@ Default:: A tuple of middleware classes to use. See :doc:`/topics/http/middleware`. -.. versionchanged:: 1.7 - - :class:`~django.contrib.sessions.middleware.SessionMiddleware`, - :class:`~django.contrib.auth.middleware.AuthenticationMiddleware`, and - :class:`~django.contrib.messages.middleware.MessageMiddleware` were removed - from this setting. - .. setting:: MIGRATION_MODULES MIGRATION_MODULES @@ -2177,8 +2118,6 @@ See also the :doc:`/topics/signing` documentation. SILENCED_SYSTEM_CHECKS ---------------------- -.. versionadded:: 1.7 - Default: ``[]`` A list of identifiers of messages generated by the system check framework @@ -2391,8 +2330,6 @@ The name of the class to use for starting the test suite. See TEST_NON_SERIALIZED_APPS ------------------------ -.. versionadded:: 1.7 - Default: ``[]`` In order to restore the database state between tests for @@ -2903,10 +2840,6 @@ scripting vulnerability into full hijacking of a user's session. There's not much excuse for leaving this off, either: if your code depends on reading session cookies from Javascript, you're probably doing it wrong. -.. versionadded:: 1.7 - -This setting also affects cookies set by :mod:`django.contrib.messages`. - .. _HTTPOnly: https://www.owasp.org/index.php/HTTPOnly .. setting:: SESSION_COOKIE_NAME @@ -2951,10 +2884,6 @@ requests and that's a good thing. .. _Firesheep: http://codebutler.com/firesheep -.. versionadded:: 1.7 - -This setting also affects cookies set by :mod:`django.contrib.messages`. - .. setting:: SESSION_ENGINE SESSION_ENGINE diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt index 445e4b9f9f..1636fee9fc 100644 --- a/docs/ref/signals.txt +++ b/docs/ref/signals.txt @@ -34,7 +34,7 @@ model system. so if your handler is a local function, it may be garbage collected. To prevent this, pass ``weak=False`` when you call the signal's :meth:`~django.dispatch.Signal.connect`. -.. versionadded:: 1.7 +.. note:: Model signals ``sender`` model can be lazily referenced when connecting a receiver by specifying its full application label. For example, an @@ -579,9 +579,7 @@ Arguments sent with this signal: don't exist, in the "teardown" phase, ``value`` is ``None``. ``enter`` - .. versionadded:: 1.7 - - A boolean; ``True`` if the setting is applied, ``False`` if restored. + A boolean; ``True`` if the setting is applied, ``False`` if restored. template_rendered ----------------- diff --git a/docs/ref/templates/api.txt b/docs/ref/templates/api.txt index 9faca5b9e1..b98d4128ad 100644 --- a/docs/ref/templates/api.txt +++ b/docs/ref/templates/api.txt @@ -442,8 +442,6 @@ If you ``pop()`` too much, it'll raise ... ContextPopException -.. versionadded:: 1.7 - You can also use ``push()`` as a context manager to ensure a matching ``pop()`` is called. @@ -490,8 +488,6 @@ tags <howto-writing-custom-template-tags>`. .. method:: Context.flatten() -.. versionadded:: 1.7 - Using ``flatten()`` method you can get whole ``Context`` stack as one dictionary including builtin variables. @@ -705,10 +701,6 @@ variables: * ``DEFAULT_MESSAGE_LEVELS`` -- A mapping of the message level names to :ref:`their numeric value <message-level-constants>`. -.. versionchanged:: 1.7 - - The ``DEFAULT_MESSAGE_LEVELS`` variable was added. - Writing your own context processors ----------------------------------- @@ -941,8 +933,6 @@ the template source, and returns a tuple: ``(template, template_origin)``. Template origin =============== -.. versionadded:: 1.7 - When an :class:`~django.template.Engine` is initialized with ``debug=True``, its templates have an ``origin`` attribute depending on the source they are loaded from. For engines initialized by Django, ``debug`` defaults to the diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index b9d2afb603..da1ec04ab3 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -665,11 +665,8 @@ the variable ``template_name``:: {% include template_name %} -.. versionchanged:: 1.7 - - The variable may also be any object with a ``render()`` method that - accepts a context. This allows you to reference a compiled ``Template`` in - your context. +The variable may also be any object with a ``render()`` method that accepts a +context. This allows you to reference a compiled ``Template`` in your context. An included template is rendered within the context of the template that includes it. This example produces the output ``"Hello, John"``: @@ -1177,10 +1174,6 @@ variable. It can be useful, for instance, in a :ttag:`blocktrans` like this:: {% widthratio this_value max_value max_width as width %} {% blocktrans %}The width is: {{ width }}{% endblocktrans %} -.. versionchanged:: 1.7 - - The ability to use "as" with this tag like in the example above was added. - .. templatetag:: with with @@ -2153,11 +2146,6 @@ When used without a format string:: ...the formatting string defined in the :setting:`TIME_FORMAT` setting will be used, without applying any localization. -.. versionchanged:: 1.7 - - The ability to receive and act on values with attached timezone - information was added in Django 1.7. - .. templatefilter:: timesince timesince @@ -2235,8 +2223,6 @@ If ``value`` is ``"Joel is a slug"``, the output will be ``"Joel i..."``. truncatechars_html ^^^^^^^^^^^^^^^^^^ -.. versionadded:: 1.7 - Similar to :tfilter:`truncatechars`, except that it is aware of HTML tags. Any tags that are opened in the string and not closed before the truncation point are closed immediately after the truncation. diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt index c82e55005e..166df30141 100644 --- a/docs/ref/utils.txt +++ b/docs/ref/utils.txt @@ -345,10 +345,6 @@ SyndicationFeed objects except ``pubdate`` and ``updateddate``, which are ``datetime.datetime`` objects, and ``enclosure``, which is an instance of the ``Enclosure`` class. - .. versionadded:: 1.7 - - The optional ``updateddate`` argument was added. - .. method:: num_items() .. method:: root_attributes() @@ -742,8 +738,6 @@ Functions for working with Python modules. .. function:: import_string(dotted_path) - .. versionadded:: 1.7 - Imports a dotted module path and returns the attribute/class designated by the last name in the path. Raises ``ImportError`` if the import failed. For example:: @@ -849,15 +843,11 @@ appropriate entities. .. class:: FixedOffset(offset=None, name=None) - .. versionadded:: 1.7 - A :class:`~datetime.tzinfo` subclass modeling a fixed offset from UTC. ``offset`` is an integer number of minutes east of UTC. .. function:: get_fixed_timezone(offset) - .. versionadded:: 1.7 - Returns a :class:`~datetime.tzinfo` instance that represents a time zone with a fixed offset from UTC. diff --git a/docs/ref/validators.txt b/docs/ref/validators.txt index d3df12b618..8f96144bb8 100644 --- a/docs/ref/validators.txt +++ b/docs/ref/validators.txt @@ -102,18 +102,14 @@ to, or in lieu of custom ``field.clean()`` methods. .. attribute:: inverse_match - .. versionadded:: 1.7 - The match mode for :attr:`regex`. Defaults to ``False``. .. attribute:: flags - .. versionadded:: 1.7 - - The flags used when compiling the regular expression string :attr:`regex`. - If :attr:`regex` is a pre-compiled regular expression, and :attr:`flags` is overridden, - :exc:`TypeError` is raised. - Defaults to `0`. + The flags used when compiling the regular expression string + :attr:`regex`. If :attr:`regex` is a pre-compiled regular expression, + and :attr:`flags` is overridden, :exc:`TypeError` is raised. Defaults + to ``0``. ``EmailValidator`` ------------------ @@ -165,10 +161,6 @@ to, or in lieu of custom ``field.clean()`` methods. .. _valid URI schemes: https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml - .. versionchanged:: 1.7 - - The optional ``schemes`` attribute was added. - .. versionchanged:: 1.8 Support for IPv6 addresses, unicode domains, and URLs containing |