Fixed #31534 -- Deprecated django.conf.urls.url().

docs/internals/deprecation.txt

@@ -81,6 +81,8 @@ details on these changes.
 * The model ``NullBooleanField`` will be removed. A stub field will remain for
   compatibility with historical migrations.
 
+* ``django.conf.urls.url()`` will be removed.
+
 See the :ref:`Django 3.1 release notes <deprecated-features-3.1>` for more
 details on these changes.
 

docs/ref/urls.txt

@@ -141,8 +141,11 @@ Helper function to return a URL pattern for serving files in debug mode::
 
 .. function:: url(regex, view, kwargs=None, name=None)
 
-This function is an alias to :func:`django.urls.re_path()`. It's likely to be
-deprecated in a future release.
+This function is an alias to :func:`django.urls.re_path()`.
+
+.. deprecated:: 3.1
+
+    Alias of :func:`django.urls.re_path` for backwards compatibility.
 
 ``handler400``
 ==============

docs/releases/1.6.txt

@@ -916,7 +916,7 @@ Miscellaneous
 * :ref:`Authentication views <built-in-auth-views>` are now reversed by name,
   not their locations in ``django.contrib.auth.views``. If you are using the
   views without a ``name``, you should update your ``urlpatterns`` to use
-  :meth:`~django.conf.urls.url` with the ``name`` parameter. For example::
+  ``django.conf.urls.url()`` with the ``name`` parameter. For example::
 
     (r'^reset/done/$', 'django.contrib.auth.views.password_reset_complete')
 

docs/releases/1.8.1.txt

@@ -48,7 +48,7 @@ Bugfixes
 
 * Updated ``urlpatterns`` examples generated by :djadmin:`startproject` to
   remove usage of referencing views by dotted path in
-  :func:`~django.conf.urls.url` which is deprecated in Django 1.8
+  ``django.conf.urls.url()`` which is deprecated in Django 1.8
   (:ticket:`24635`).
 
 * Fixed queries where an expression was referenced in ``order_by()``, but wasn't

docs/releases/1.8.txt

@@ -1270,7 +1270,7 @@ Thus ``patterns()`` serves little purpose and is a burden when teaching new user
 (answering the newbie's question "why do I need this empty string as the first
 argument to ``patterns()``?"). For these reasons, we are deprecating it.
 Updating your code is as simple as ensuring that ``urlpatterns`` is a list of
-:func:`django.conf.urls.url` instances. For example::
+``django.conf.urls.url()`` instances. For example::
 
     from django.conf.urls import url
     from myapp import views
@@ -1280,8 +1280,8 @@ Updating your code is as simple as ensuring that ``urlpatterns`` is a list of
         url('^other/$', views.otherview),
     ]
 
-Passing a string as ``view`` to :func:`~django.conf.urls.url`
--------------------------------------------------------------
+Passing a string as ``view`` to ``django.conf.urls.url()``
+----------------------------------------------------------
 
 Related to the previous item, referencing views as strings in the ``url()``
 function is deprecated. Pass the callable view as described in the previous
@@ -1319,7 +1319,7 @@ instead.
 
 Related to the previous item, the ``prefix`` argument to
 :func:`django.conf.urls.i18n.i18n_patterns` has been deprecated. Simply pass a
-list of :func:`django.conf.urls.url` instances instead.
+list of ``django.conf.urls.url()`` instances instead.
 
 Using an incorrect count of unpacked values in the :ttag:`for` template tag
 ---------------------------------------------------------------------------

docs/releases/1.9.txt

@@ -1289,7 +1289,7 @@ to:
 
 This change also means that the old way of including an ``AdminSite`` instance
 is deprecated. Instead, pass ``admin.site.urls`` directly to
-:func:`~django.conf.urls.url()`:
+``django.conf.urls.url()``:
 
 .. code-block:: python
     :caption: urls.py

docs/releases/3.1.txt

@@ -754,6 +754,9 @@ Miscellaneous
 * The ``NullBooleanField`` model field is deprecated in favor of
   ``BooleanField(null=True)``.
 
+* ``django.conf.urls.url()`` alias of :func:`django.urls.re_path` is
+  deprecated.
+
 .. _removed-features-3.1:
 
 Features removed in 3.1