Improve description of --disable-rpath workaround for regression test

problems.

diff --git a/doc/src/sgml/regress.sgml b/doc/src/sgml/regress.sgml
index ca4b6d0c01ffdc1ce8cd6725539b590969de65ca..cff867bf68439a86f07ac729c96fe77ed233c765 100644 (file)
--- a/doc/src/sgml/regress.sgml
+++ b/doc/src/sgml/regress.sgml
@@ -47,10 +47,6 @@ gmake check
    <filename>src/test/regress</filename> and run the command there.)
    This will first build several auxiliary files, such as
    some sample user-defined trigger functions, and then run the test driver
-   script. On some platforms if you want perform a <literal>make check<literal>
-   without installing it first, you have to build with:
-   <literal>configure --disable-rpath</>.
-   At the end you should see something like
    script.  At the end you should see something like
 <screen>
 <computeroutput>
@@ -85,6 +81,19 @@ gmake check
     Alternatively, run the tests after installation.
    </para>
 
+   <para>
+    If you have configured <productname>PostgreSQL</productname> to install
+    into a location where an older <productname>PostgreSQL</productname>
+    installation already exists, and you perform <literal>gmake check</>
+    before installing the new version, you may find that the tests fail
+    because the new programs try to use the already-installed shared
+    libraries.  (Typical symptoms are complaints about undefined symbols.)
+    If you wish to run the tests before overwriting the old installation,
+    you'll need to build with <literal>configure --disable-rpath</>.
+    It is not recommended that you use this option for the final installation,
+    however.
+   </para>
+
    <para>
     The parallel regression test starts quite a few processes under your
     user ID.  Presently, the maximum concurrency is twenty parallel test