summaryrefslogtreecommitdiff
path: root/docs/topics
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2015-12-10 11:23:12 -0500
committerTim Graham <timograham@gmail.com>2015-12-11 08:07:43 -0500
commit9f3ce6d987f2a78dc97f6147efac41071c2ec085 (patch)
tree8271c3ab931ca324c056c58efd6d747875a0fdda /docs/topics
parent515f149e4d51ddcf32db0be440da726c0ca867b4 (diff)
[1.9.x] Refs #25899 -- Improved visibility of TEST database settings in testing docs.
Backport of 738bda8a6feea95d07b73246365e75b3d25e3466 from master
Diffstat (limited to 'docs/topics')
-rw-r--r--docs/topics/testing/overview.txt16
1 files changed, 8 insertions, 8 deletions
diff --git a/docs/topics/testing/overview.txt b/docs/topics/testing/overview.txt
index 1d11d71553..1fd8a1c9f8 100644
--- a/docs/topics/testing/overview.txt
+++ b/docs/topics/testing/overview.txt
@@ -153,14 +153,14 @@ when all the tests have been executed.
be created. Any migrations will also be applied in order to keep it
up to date.
-By default the test databases get their names by prepending ``test_``
-to the value of the :setting:`NAME` settings for the databases
-defined in :setting:`DATABASES`. When using the SQLite database engine
-the tests will by default use an in-memory database (i.e., the
-database will be created in memory, bypassing the filesystem
-entirely!). If you want to use a different database name, specify
-:setting:`NAME <TEST_NAME>` in the :setting:`TEST <DATABASE-TEST>`
-dictionary for any given database in :setting:`DATABASES`.
+The default test database names are created by prepending ``test_`` to the
+value of each :setting:`NAME` in :setting:`DATABASES`. When using SQLite, the
+tests will use an in-memory database by default (i.e., the database will be
+created in memory, bypassing the filesystem entirely!). The :setting:`TEST
+<DATABASE-TEST>` dictionary in :setting:`DATABASES` offers a number of settings
+to configure your test database. For example, if you want to use a different
+database name, specify :setting:`NAME <TEST_NAME>` in the :setting:`TEST
+<DATABASE-TEST>` dictionary for any given database in :setting:`DATABASES`.
On PostgreSQL, :setting:`USER` will also need read access to the built-in
``postgres`` database.