summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2017-01-10 09:57:49 -0500
committerTim Graham <timograham@gmail.com>2017-01-17 20:52:00 -0500
commitad393beeb71e8774e4bf9ad842b97022e50f1231 (patch)
tree7ae0a539e53c582865a57273d902b3f29192d699 /docs
parentc6de8cca208fb471723619970c09ecb3bd335362 (diff)
Refs #21927 -- Removed include()'s app_name argument per deprecation timeline.
Also removed support for passing a 3-tuple to include() and support for setting an instance namespace without an application namespace. Thanks Marten Kenbeek for completing the patch.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/urls.txt24
-rw-r--r--docs/releases/2.0.txt8
2 files changed, 11 insertions, 21 deletions
diff --git a/docs/ref/urls.txt b/docs/ref/urls.txt
index d1464da66d..505295ede4 100644
--- a/docs/ref/urls.txt
+++ b/docs/ref/urls.txt
@@ -53,10 +53,9 @@ parameter is useful.
``include()``
=============
-.. function:: include(module, namespace=None, app_name=None)
+.. function:: include(module, namespace=None)
include(pattern_list)
include((pattern_list, app_namespace), namespace=None)
- include((pattern_list, app_namespace, instance_namespace))
A function that takes a full Python import path to another URLconf module
that should be "included" in this place. Optionally, the :term:`application
@@ -68,15 +67,12 @@ parameter is useful.
can be used to set a different instance namespace.
``include()`` also accepts as an argument either an iterable that returns
- URL patterns, a 2-tuple containing such iterable plus the names of the
- application namespaces, or a 3-tuple containing the iterable and the names
- of both the application and instance namespace.
+ URL patterns or a 2-tuple containing such iterable plus the names of the
+ application namespaces.
:arg module: URLconf module (or module name)
:arg namespace: Instance namespace for the URL entries being included
:type namespace: string
- :arg app_name: Application namespace for the URL entries being included
- :type app_name: string
:arg pattern_list: Iterable of :func:`django.conf.urls.url` instances
:arg app_namespace: Application namespace for the URL entries being included
:type app_namespace: string
@@ -85,20 +81,6 @@ parameter is useful.
See :ref:`including-other-urlconfs` and :ref:`namespaces-and-include`.
-.. deprecated:: 1.9
-
- Support for the ``app_name`` argument is deprecated and will be removed in
- Django 2.0. Specify the ``app_name`` as explained in
- :ref:`namespaces-and-include` instead.
-
- Support for passing a 3-tuple is also deprecated and will be removed in
- Django 2.0. Pass a 2-tuple containing the pattern list and application
- namespace, and use the ``namespace`` argument instead.
-
- Lastly, support for an instance namespace without an application namespace
- has been deprecated and will be removed in Django 2.0. Specify the
- application namespace or remove the instance namespace.
-
``handler400``
==============
diff --git a/docs/releases/2.0.txt b/docs/releases/2.0.txt
index 348572a75f..0ae25a8295 100644
--- a/docs/releases/2.0.txt
+++ b/docs/releases/2.0.txt
@@ -291,3 +291,11 @@ these features.
* The ``mime_type`` attribute of ``django.utils.feedgenerator.Atom1Feed`` and
``django.utils.feedgenerator.RssFeed`` is removed.
+
+* The ``app_name`` argument to ``include()`` is removed.
+
+* Support for passing a 3-tuple as the first argument to ``include()`` is
+ removed.
+
+* Support for setting a URL instance namespace without an application namespace
+ is removed.