From: Michael Paquier <michael@paquier.xyz>
Date: Sun, 31 May 2020 01:48:21 +0000 (+0900)
Subject: Doc: Mention about caveats of --concurrently on reindexdb page
X-Git-Tag: REL_13_BETA2~93
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=9b60c4b979bce060495e2b05ba01d1cc6bffdd2d;p=thirdparty%2Fpostgresql.git

Doc: Mention about caveats of --concurrently on reindexdb page

The documentation of REINDEX includes a complete description of
CONCURRENTLY and its advantages as well as its disadvantages, but
reindexdb was not really clear about all that.

From discussion with Tom Lane, based on a report from Andrey Klychkov.

Discussion: https://postgr.es/m/1590486572.205117372@f500.i.mail.ru
Backpatch-through: 12
---

diff --git a/doc/src/sgml/ref/reindexdb.sgml b/doc/src/sgml/ref/reindexdb.sgml
index f6c3d9538bb..026fd018d93 100644
--- a/doc/src/sgml/ref/reindexdb.sgml
+++ b/doc/src/sgml/ref/reindexdb.sgml
@@ -122,8 +122,9 @@ PostgreSQL documentation
       <term><option>--concurrently</option></term>
       <listitem>
        <para>
-        Use the <literal>CONCURRENTLY</literal> option.  See <xref
-        linkend="sql-reindex"/> for further information.
+        Use the <literal>CONCURRENTLY</literal> option.  See
+        <xref linkend="sql-reindex"/>, where all the caveats of this option
+        are explained in detail.
        </para>
       </listitem>
      </varlistentry>