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 860c579a3f004a89a21419bcc63f77d28c223862..3403fb91afc9de5d5755ad8d87c95fe171171022 100644 (file)
--- a/doc/src/sgml/ref/reindexdb.sgml
+++ b/doc/src/sgml/ref/reindexdb.sgml
@@ -122,8 +122,9 @@ PostgreSQL documentation
       --concurrently
       
        
-        Use the CONCURRENTLY option.  See 
-        linkend="sql-reindex"/> for further information.
+        Use the CONCURRENTLY option.  See
+        , where all the caveats of this option
+        are explained in detail.