commit 0e40cb47189062433b99c1e33e75a096c7c97dd8
Author: Michael Paquier <michael@otacoo.com>
Date:   Fri Dec 6 13:13:23 2013 +0900

    Addition of in-core test suite restrictions in documentation
    
    Mention in the documentation of regression tests limitations related to
    the database where tests are run as well as possible inconsistencies
    for server parameters.

diff --git a/doc/src/sgml/regress.sgml b/doc/src/sgml/regress.sgml
index 2b95587..719210b 100644
--- a/doc/src/sgml/regress.sgml
+++ b/doc/src/sgml/regress.sgml
@@ -257,6 +257,24 @@ gmake check EXTRA_TESTS=collate.linux.utf8 LANG=en_US.utf8
     platforms, and only when run in a database that uses UTF-8 encoding.
    </para>
   </sect2>
+
+  <sect2>
+   <title>Restrictions</title>
+
+   <para>
+    Regression tests should be run on a database named <literal>regression</>
+    to prevent failures of tests using directly or indirectly the current
+    database name in output results. <literal>regression</> is the default
+    database name for tests on core, and contrib modules use
+    <literal>contrib_regression</> as default.
+   </para>
+
+   <para>
+    Parameters able to change the output of queries like enable/disable flags
+    described in <xref linkend="runtime-config-query-enable"> for
+    <command>EXPLAIN</> should use default values as well.
+   </para>
+  </sect2>
   </sect1>
 
   <sect1 id="regress-evaluation">