Fixed #21977 -- Deprecated SimpleTestCase.urls

docs/internals/deprecation.txt

@@ -20,6 +20,8 @@ about each item can often be found in the release notes of two versions prior.
 * Support for the ``prefix`` argument to
   ``django.conf.urls.i18n.i18n_patterns()`` will be removed.
 
+* ``SimpleTestCase.urls`` will be removed.
+
 .. _deprecation-removed-in-1.9:
 
 1.9

docs/releases/1.8.txt

@@ -256,6 +256,14 @@ Updating your code is as simple as ensuring that ``urlpatterns`` is a list of
         url('^other/$', views.otherview),
     ]
 
+``django.test.SimpleTestCase.urls``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The attribute :attr:`SimpleTestCase.urls <django.test.SimpleTestCase.urls>`
+for specifying URLconf configuration in tests has been deprecated and will be
+removed in Django 2.0. Use :func:`@override_settings(ROOT_URLCONF=...)
+<django.test.override_settings>` instead.
+
 ``prefix`` argument to :func:`~django.conf.urls.i18n.i18n_patterns`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

docs/topics/testing/tools.txt

@@ -961,6 +961,11 @@ URLconf configuration
 
 .. attribute:: SimpleTestCase.urls
 
+.. deprecated:: 1.8
+
+    Use ``@override_settings(ROOT_URLCONF=...)`` instead for URLconf
+    configuration.
+
 If your application provides views, you may want to include tests that use the
 test client to exercise those views. However, an end user is free to deploy the
 views in your application at any URL of their choosing. This means that your