From a3db480393d0065fc69834057f0e02a4afc65df9 Mon Sep 17 00:00:00 2001
From: Chris Jerdonek <chris.jerdonek@gmail.com>
Date: Mon, 15 Aug 2016 07:10:40 -0700
Subject: Fixed #27061 -- Added a TEST['TEMPLATE'] setting for PostgreSQL.

---
 docs/ref/databases.txt | 10 ++++++++++
 docs/ref/settings.txt  | 14 ++++++++++++++
 docs/releases/1.11.txt |  3 +++
 3 files changed, 27 insertions(+)

(limited to 'docs')

diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt
index 983b7525c3..257324330d 100644
--- a/docs/ref/databases.txt
+++ b/docs/ref/databases.txt
@@ -164,6 +164,16 @@ lookups that use the ``LIKE`` operator in their SQL, as is done with the
 
 .. _PostgreSQL operator class: http://www.postgresql.org/docs/current/static/indexes-opclass.html
 
+Test database templates
+-----------------------
+
+.. versionadded:: 1.11
+
+You can use the :setting:`TEST['TEMPLATE'] <TEST_TEMPLATE>` setting to specify
+a `template`_ (e.g. ``'template0'``) from which to create a test database.
+
+.. _template: https://www.postgresql.org/docs/current/static/sql-createdatabase.html
+
 Speeding up test execution with non-durable settings
 ----------------------------------------------------
 
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index 445e504e98..856d9186a8 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -738,6 +738,20 @@ the database state between tests if you don't have transactions). You can set
 this to ``False`` to speed up creation time if you don't have any test classes
 with :ref:`serialized_rollback=True <test-case-serialized-rollback>`.
 
+.. setting:: TEST_TEMPLATE
+
+``TEMPLATE``
+^^^^^^^^^^^^
+
+.. versionadded:: 1.11
+
+This is a PostgreSQL-specific setting.
+
+The name of a `template`_ (e.g. ``'template0'``) from which to create the test
+database.
+
+.. _template: https://www.postgresql.org/docs/current/static/sql-createdatabase.html
+
 .. setting:: TEST_CREATE
 
 ``CREATE_DB``
diff --git a/docs/releases/1.11.txt b/docs/releases/1.11.txt
index 802a09e6a9..b9fe8de41d 100644
--- a/docs/releases/1.11.txt
+++ b/docs/releases/1.11.txt
@@ -159,6 +159,9 @@ Database backends
   on PostgreSQL 9.5+ and Oracle to execute queries with
   ``FOR UPDATE SKIP LOCKED``.
 
+* Added the :setting:`TEST['TEMPLATE'] <TEST_TEMPLATE>` setting to let
+  PostgreSQL users specify a template for creating the test database.
+
 Email
 ~~~~~
 
-- 
cgit v1.3