Ticket #3051: 3051_testing.diff

docs/topics/testing.txt

@@ -311 +311 @@
 but not gracefully. No details of the tests run before the interruption will
 be reported, and any test databases created by the run will not be destroyed.
 
+
+Using tests outside the test runner
+-----------------------------------
+
+If you want to run tests outside of ``./manage.py test`` - for example in your 
+views, or in the shell - you will need to set up the test environment first.
+You can do this by running :meth:`django.test.utils.setup_test_environment`::
+
+
+    >>> from django.test.utils import setup_test_environment
+    >>> setup_test_environment()
+
+Note that this is done for you automatically by `./manage.py test`, and is only 
+needed if you're not using running your tests via that command.
+
+
 The test database
 -----------------