diff options
| author | Tim Graham <timograham@gmail.com> | 2016-01-11 20:59:34 -0500 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2016-01-14 18:21:33 -0500 |
| commit | e519aab43a419589e92fe284e4ce2f2e034aec6a (patch) | |
| tree | e1af3c01ca87ff9b639ac45ec97ac9869d273c43 /docs/topics/testing | |
| parent | fd1c5bb041abb617dc58c336a8461fb3a7af4508 (diff) | |
Fixed #23868 -- Added support for non-unique django-admin-options in docs.
Also documented missing short command line options to fix #24134. This bumps
the minimum sphinx version required to build the docs to 1.3.4.
Thanks Simon Charette for review.
Diffstat (limited to 'docs/topics/testing')
| -rw-r--r-- | docs/topics/testing/overview.txt | 21 | ||||
| -rw-r--r-- | docs/topics/testing/tools.txt | 5 |
2 files changed, 13 insertions, 13 deletions
diff --git a/docs/topics/testing/overview.txt b/docs/topics/testing/overview.txt index 8f01f0c8a8..1674a40a39 100644 --- a/docs/topics/testing/overview.txt +++ b/docs/topics/testing/overview.txt @@ -115,9 +115,10 @@ wait for the currently running test to complete and then exit gracefully. During a graceful exit the test runner will output details of any test failures, report on how many tests were run and how many errors and failures were encountered, and destroy any test databases as usual. Thus pressing -``Ctrl-C`` can be very useful if you forget to pass the :djadminopt:`--failfast` -option, notice that some tests are unexpectedly failing, and want to get details -on the failures without waiting for the full test run to complete. +``Ctrl-C`` can be very useful if you forget to pass the :option:`--failfast +<test --failfast>` option, notice that some tests are unexpectedly failing and +want to get details on the failures without waiting for the full test run to +complete. If you do not want to wait for the currently running test to finish, you can press ``Ctrl-C`` a second time and the test run will halt immediately, @@ -145,10 +146,10 @@ Tests that require a database (namely, model tests) will not use your "real" Regardless of whether the tests pass or fail, the test databases are destroyed when all the tests have been executed. -You can prevent the test databases from being destroyed by adding the -:djadminopt:`--keepdb` flag to the test command. This will preserve the test -database between runs. If the database does not exist, it will first be -created. Any migrations will also be applied in order to keep it p to date. +You can prevent the test databases from being destroyed by using the +:option:`test --keepdb` option. This will preserve the test database between +runs. If the database does not exist, it will first be created. Any migrations +will also be applied in order to keep it p to date. The default test database names are created by prepending ``test_`` to the value of each :setting:`NAME` in :setting:`DATABASES`. When using SQLite, the @@ -221,9 +222,9 @@ the Django test runner reorders tests in the following way: database by a given :class:`~django.test.TransactionTestCase` test, they must be updated to be able to run independently. -You may reverse the execution order inside groups by passing -:djadminopt:`--reverse` to the test command. This can help with ensuring your -tests are independent from each other. +You may reverse the execution order inside groups using the :option:`test +--reverse` option. This can help with ensuring your tests are independent from +each other. .. _test-case-serialized-rollback: diff --git a/docs/topics/testing/tools.txt b/docs/topics/testing/tools.txt index e6e8fe52e9..9c50aa0f9f 100644 --- a/docs/topics/testing/tools.txt +++ b/docs/topics/testing/tools.txt @@ -833,9 +833,8 @@ available port in the ``8081-8179`` range. Its full URL can be accessed with In earlier versions, the live server's default address was always ``'localhost:8081'``. -If you'd like to select another address then you may pass a different one to -the :djadmin:`test` command via the :djadminopt:`--liveserver` option, for -example: +If you'd like to select another address, you may pass a different one using the +:option:`test --liveserver` option, for example: .. code-block:: console |
