doc: PG 13 rels: use xref labels referencing ref/*.sgml files

This avoids using <link> and supplied text.

diff --git a/doc/src/sgml/release-13.sgml b/doc/src/sgml/release-13.sgml
index ea39fe395cc5a93b9352978b9538cdd780cb53cc..c39a6ad38ef74dbe0e4c1c0f25351b2801103f22 100644 (file)
--- a/doc/src/sgml/release-13.sgml
+++ b/doc/src/sgml/release-13.sgml
@@ -338,10 +338,10 @@ Author: Peter Eisentraut <[email protected]>
         partitioned tables can be published explicitly causing all partitions
         to be automatically published.  Addition/removal of partitions from
         partitioned tables are automatically added/removed from publications.
-        The <link linkend="sql-createpublication"><command>CREATE
-        PUBLICATION</command></link> option
-        <literal>publish_via_partition_root</literal> controls whether changes
-        to partitions are published as their own or their ancestor's.
+        The <xref linkend="sql-createpublication"/> option
+        <literal>publish_via_partition_root</literal> controls whether
+        changes to partitions are published as their own or their
+        ancestor's.
        </para>
       </listitem>
 
@@ -397,11 +397,9 @@ Author: Peter Geoghegan <[email protected]>
 
        <para>
         This allows efficient btree indexing of low cardinality columns
-        by storing duplicate keys only once.  Users upgrading with <link
-        linkend="pgupgrade"><application>pg_upgrade</application></link>
-        will need to use <link
-        linkend="sql-reindex"><command>REINDEX</command></link> to make use
-        of this feature.
+        by storing duplicate keys only once.  Users upgrading
+        with <xref linkend="pgupgrade"/> will need to use <xref
+        linkend="sql-reindex"/> to make use of this feature.
        </para>
       </listitem>
 
@@ -414,8 +412,8 @@ Author: Alexander Korotkov <[email protected]>
 -->
 
        <para>
-        Allow <link linkend="gist">GiST</link> and <link
-        linkend="spgist">SP-GiST</link> indexes for <link
+        Allow <xref linkend="gist"/> and <xref
+        linkend="spgist"/> indexes for <link
         linkend="datatype-line">box</link>/point distance lookups (Nikita
         Glukhov)
        </para>
@@ -428,9 +426,9 @@ Author: Alexander Korotkov <[email protected]>
 -->
 
        <para>
-        Allow <link linkend="gin"><acronym>GIN</acronym></link> indexes to
-        more efficiently handle <literal>NOT</literal> restrictions (Nikita
-        Glukhov, Alexander Korotkov, Tom Lane, Julien Rouhaud)
+        Allow <xref linkend="gin"/> indexes to more efficiently handle
+        <literal>NOT</literal> restrictions (Nikita Glukhov, Alexander
+        Korotkov, Tom Lane, Julien Rouhaud)
        </para>
       </listitem>
 
@@ -658,8 +656,8 @@ Author: David Rowley <[email protected]>
 -->
 
        <para>
-        Allow inserts to trigger <link linkend="autovacuum">autovacuum</link>
-        activity (Laurenz Albe, Darafei Praliaskouski)
+        Allow inserts to trigger <xref linkend="autovacuum"/> activity
+        (Laurenz Albe, Darafei Praliaskouski)
        </para>
 
        <para>
@@ -722,9 +720,9 @@ Author: Fujii Masao <[email protected]>
 -->
 
        <para>
-        Improve the performance when replaying <link
-        linkend="sql-dropdatabase"><command>DROP DATABASE</command></link>
-        commands when many tablespaces are in use (Fujii Masao)
+        Improve the performance when replaying <xref
+        linkend="sql-dropdatabase"/> commands when many tablespaces are
+        in use (Fujii Masao)
        </para>
       </listitem>
 
@@ -747,9 +745,8 @@ Author: Tomas Vondra <[email protected]>
 -->
 
        <para>
-        Improve speed of <link
-        linkend="storage-toast"><acronym>TOAST</acronym></link> decompression
-        and the retrieval of only the leading bytes of <acronym>TOAST</acronym>
+        Improve speed of <xref linkend="storage-toast"/> decompression and
+        the retrieval of only the leading bytes of <acronym>TOAST</acronym>
         values (Binguo Bao, Andrey Borodin)
        </para>
 
@@ -769,9 +766,9 @@ Author: Tom Lane <[email protected]>
 -->
 
        <para>
-        Improve performance of <link
-        linkend="sql-listen"><command>LISTEN</command></link>/<command>NOTIFY</command>
-        (Martijn van Oosterhout)
+        Improve performance of <xref
+        linkend="sql-listen"/>/<command>NOTIFY</command> (Martijn van
+        Oosterhout)
        </para>
       </listitem>
 
@@ -782,8 +779,8 @@ Author: Tom Lane <[email protected]>
 -->
 
        <para>
-        Improve the efficiency of removing duplicate <link
-        linkend="sql-notify"><command>NOTIFY</command></link> events (Tom Lane)
+        Improve the efficiency of removing duplicate <xref
+        linkend="sql-notify"/> events (Tom Lane)
        </para>
       </listitem>
 
@@ -830,9 +827,9 @@ Author: Amit Kapila <[email protected]>
 -->
 
        <para>
-        Allow <link linkend="sql-explain"><command>EXPLAIN</command></link>,
-        <xref linkend="auto-explain"/>, <link
-        linkend="autovacuum">autovacuum</link>, and <xref
+        Allow <xref linkend="sql-explain"/>,
+        <xref linkend="auto-explain"/>, <xref
+        linkend="autovacuum"/>, and <xref
         linkend="pgstatstatements"/> to track <acronym>WAL</acronym> usage
         statistics (Kirill Bychik, Julien Rouhaud)
        </para>
@@ -898,7 +895,7 @@ Author: Alvaro Herrera <[email protected]>
 -->
 
        <para>
-        Make <link linkend="sql-vacuum">vacuum</link> buffer counters 64-bits
+        Make <xref linkend="sql-vacuum"/> buffer counters 64-bits
         wide to avoid overflow (&Aacute;lvaro Herrera)
        </para>
       </listitem>
@@ -982,8 +979,8 @@ Author: Alvaro Herrera <[email protected]>
        <para>
         Add system view <link
         linkend="monitoring-stats-dynamic-views-table"><structname>pg_stat_progress_analyze</structname></link>
-        to report <link linkend="sql-analyze">analyze</link> progress
-        (&Aacute;lvaro Herrera, Tatsuro Yamada, Vinayak Pokale)
+        to report <xref linkend="sql-analyze"/> progress (&Aacute;lvaro
+        Herrera, Tatsuro Yamada, Vinayak Pokale)
        </para>
       </listitem>
 
@@ -1363,8 +1360,8 @@ Author: Amit Kapila <[email protected]>
 -->
 
       <para>
-       Allow <link linkend="sql-vacuum"><command>VACUUM</command></link>
-       to process indexes in parallel (Masahiko Sawada, Amit Kapila)
+       Allow <xref linkend="sql-vacuum"/> to process indexes in parallel
+       (Masahiko Sawada, Amit Kapila)
       </para>
 
       <para>
@@ -1392,8 +1389,7 @@ Author: Fujii Masao <[email protected]>
 -->
 
       <para>
-       Report planning-time buffer usage in <link
-       linkend="sql-explain"><command>EXPLAIN</command></link>'s
+       Report planning-time buffer usage in <xref linkend="sql-explain"/>'s
        <literal>BUFFER</literal> output (Julien Rouhaud)
       </para>
      </listitem>
@@ -1444,9 +1440,9 @@ Author: Peter Eisentraut <[email protected]>
 -->
 
       <para>
-       Add <link linkend="sql-altertable"><command>ALTER
-       TABLE</command></link> clause <literal>DROP EXPRESSION</literal>
-       to remove generated properties from columns (Peter Eisentraut)
+       Add <xref linkend="sql-altertable"/> clause <literal>DROP
+       EXPRESSION</literal> to remove generated properties from columns
+       (Peter Eisentraut)
       </para>
      </listitem>
 
@@ -1469,8 +1465,8 @@ Author: Fujii Masao <[email protected]>
 -->
 
       <para>
-       Add <link linkend="sql-alterview"><command>ALTER VIEW</command></link>
-       syntax to rename view columns (Fujii Masao)
+       Add <xref linkend="sql-alterview"/> syntax to rename view columns
+       (Fujii Masao)
       </para>
 
       <para>
@@ -1486,9 +1482,9 @@ Author: Tom Lane <[email protected]>
 -->
 
       <para>
-       Add <link linkend="sql-altertype"><command>ALTER TYPE</command></link>
-       options useful for extensions, like <acronym>TOAST</acronym> and I/O
-       functions control (Tomas Vondra, Tom Lane)
+       Add <xref linkend="sql-altertype"/> options useful for extensions,
+       like <acronym>TOAST</acronym> and I/O functions control (Tomas
+       Vondra, Tom Lane)
       </para>
      </listitem>
 
@@ -1499,9 +1495,8 @@ Author: Peter Eisentraut <[email protected]>
 -->
 
       <para>
-       Add <link linkend="sql-createdatabase"><command>CREATE
-       DATABASE</command></link> <literal>LOCALE</literal> option (Peter
-       Eisentraut)
+       Add <xref linkend="sql-createdatabase"/> <literal>LOCALE</literal>
+       option (Peter Eisentraut)
       </para>
 
       <para>
@@ -1517,9 +1512,8 @@ Author: Amit Kapila <[email protected]>
 -->
 
       <para>
-       Allow <link linkend="sql-dropdatabase"><command>DROP
-       DATABASE</command></link> to disconnect users so drop succeeds (Pavel
-       Stehule, Amit Kapila)
+       Allow <xref linkend="sql-dropdatabase"/> to disconnect users so
+       drop succeeds (Pavel Stehule, Amit Kapila)
       </para>
 
       <para>
@@ -1952,7 +1946,7 @@ Author: Alvaro Herrera <[email protected]>
    </sect3>
 
    <sect3>
-    <title><link linkend="plpgsql">PL/pgSQL</link></title>
+    <title><xref linkend="plpgsql"/></title>
 
     <itemizedlist>
 
@@ -2306,9 +2300,8 @@ Author: Robert Haas <[email protected]>
       </para>
 
       <para>
-       A new tool <link
-       linkend="app-pgverifybackup"><application>pg_verifybackup</application>"</link>
-       can verify backups.
+       A new tool <application><xref
+       linkend="app-pgverifybackup"/></application> can verify backups.
       </para>
      </listitem>
 
@@ -2319,9 +2312,9 @@ Author: Author: Fujii Masao <[email protected]>
 -->
 
       <para>
-       Have <link
-       linkend="app-pgbasebackup"><application>pg_basebackup</application></link>
-       estimate the total backup size by default (Fujii Masao)
+       Have <application><xref
+       linkend="app-pgbasebackup"/></application> estimate the
+       total backup size by default (Fujii Masao)
       </para>
 
       <para>
@@ -2340,14 +2333,13 @@ Author: Alvaro Herrera <[email protected]>
 -->
 
       <para>
-       Add <link
-       linkend="app-pgrewind"><application>pg_rewind</application></link>
+       Add <application><xref linkend="app-pgrewind"/></application>
        option to configure standbys (Paul Guo, Jimmy Yih, Ashwin Agrawal)
       </para>
 
       <para>
-       This matches <link
-       linkend="app-pgbasebackup"><application>pg_basebackup</application></link>'s
+       This matches <application><xref
+       linkend="app-pgbasebackup"/></application>'s
        <option>--write-recovery-conf</option> option.
       </para>
      </listitem>
@@ -2393,9 +2385,8 @@ Author: Fujii Masao <[email protected]>
 -->
 
       <para>
-       Increase <link linkend="sql-prepare-transaction"><command>PREPARE
-       TRANSACTION</command></link> information reported by
-       <application>pg_waldump</application> (Fujii Masao)
+       Increase <xref linkend="sql-prepare-transaction"/> information
+       reported by <application>pg_waldump</application> (Fujii Masao)
       </para>
      </listitem>
 
@@ -2406,10 +2397,9 @@ Author: Robert Haas <[email protected]>
 -->
 
       <para>
-       Add <link
-       linkend="pgwaldump"><application>pg_waldump</application></link>
-       option <option>--quiet</option> to suppress non-error output (Andres
-       Freund, Robert Haas)
+       Add <application><xref linkend="pgwaldump"/></application>
+       option <option>--quiet</option> to suppress non-error output
+       (Andres Freund, Robert Haas)
       </para>
      </listitem>
 
@@ -2420,8 +2410,7 @@ Author: Alvaro Herrera <[email protected]>
 -->
 
       <para>
-       Allow <link
-       linkend="app-pgdump"><application>pg_dump</application></link>
+       Allow <application><xref linkend="app-pgdump"/></application>
        <option>--include-foreign-data</option> to dump data from foreign
        servers (Luis Carril)
       </para>
@@ -2434,8 +2423,8 @@ Author: Amit Kapila <[email protected]>
 -->
 
       <para>
-       Allow vacuum commands run by <link
-       linkend="app-vacuumdb">vacuumdb</link> to operate in parallel mode
+       Allow vacuum commands run by <application><xref
+       linkend="app-vacuumdb"/></application> to operate in parallel mode
        (Masahiko Sawada)
       </para>
 
@@ -2451,8 +2440,8 @@ Author: Michael Paquier <[email protected]>
 -->
 
       <para>
-       Allow <link linkend="app-reindexdb">reindexdb</link> to operate in
-       parallel (Julien Rouhaud)
+       Allow <application><xref linkend="app-reindexdb"/></application>
+       to operate in parallel (Julien Rouhaud)
       </para>
 
       <para>
@@ -2467,8 +2456,8 @@ Author: Amit Kapila <[email protected]>
 -->
 
       <para>
-       Allow <link linkend="app-dropdb">dropdb</link> to force disconnections
-       so the drop succeeds (Pavel Stehule)
+       Allow <application><xref linkend="app-dropdb"/></application>
+       to force disconnections so the drop succeeds (Pavel Stehule)
       </para>
 
       <para>
@@ -2484,7 +2473,7 @@ Author: Author: Michael Paquier <[email protected]>
 
       <para>
        Remove <option>--adduser</option> and <option>--no-adduser</option>
-       from <link linkend="app-createuser">createuser</link> (Alexander
+       from <application><xref linkend="app-createuser"/></application> (Alexander
        Lakhin)
       </para>
 
@@ -2501,9 +2490,9 @@ Author: Peter Eisentraut <[email protected]>
 -->
 
       <para>
-       Use the directory of the <link
-       linkend="pgupgrade"><application>pg_upgrade</application></link>
-       binary as the default new 'bindir' location when running
+       Use the directory of the <application><xref
+       linkend="pgupgrade"/></application> binary
+       as the default new 'bindir' location when running
        <application>pg_upgrade</application> (Daniel Gustafsson)
       </para>
      </listitem>
@@ -2712,8 +2701,7 @@ Author: Joe Conway <[email protected]>
 -->
 
       <para>
-       Add <link linkend="sql-truncate"><command>TRUNCATE</command></link>
-       command hook (Yuli Khodorkovskiy)
+       Add <xref linkend="sql-truncate"/> command hook (Yuli Khodorkovskiy)
       </para>
      </listitem>
 
@@ -2860,8 +2848,7 @@ Author: Andrew Dunstan <[email protected]>
       </para>
 
       <para>
-       Specifically, allow <link linkend="sql-alterusermapping"><command>ALTER
-       USER MAPPING</command></link> to set
+       Specifically, allow <xref linkend="sql-alterusermapping"/> to set
        <literal>password_required</literal> to false.  Care must still be
        taken to avoid non-superusers from using superuser credentials to
        connect to the foreign server.