Doc: adjust misleading phrasing of a few cross-references.
authorTom Lane <tgl@sss.pgh.pa.us>
Fri, 23 Sep 2022 02:05:09 +0000 (22:05 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Fri, 23 Sep 2022 02:05:09 +0000 (22:05 -0400)
The pg_dump and pg_dumpall man pages referred to app-psql-patterns
as appearing "below", which I suspect was copied-and-pasted from
equivalent text in psql-ref.sgml rather than being actually thought
through.  At least to me, that phrasing means "later in this same
web page/section", which this link target is not.  Drop the
misleading and unnecessary-in-any-case adjective.

doc/src/sgml/ref/pg_dump.sgml
doc/src/sgml/ref/pg_dumpall.sgml

index c08276bc0aaebae078fe63182a8183dbf4ae4d84..8b9d9f4cad430d9673ae533b46e77dcc439f17af 100644 (file)
@@ -415,7 +415,7 @@ PostgreSQL documentation
         <replaceable class="parameter">pattern</replaceable> parameter is
         interpreted as a pattern according to the same rules used by
         <application>psql</application>'s <literal>\d</literal> commands
-        (see <xref linkend="app-psql-patterns"/> below),
+        (see <xref linkend="app-psql-patterns"/>),
         so multiple schemas can also be selected by writing wildcard characters
         in the pattern.  When using wildcards, be careful to quote the pattern
         if needed to prevent the shell from expanding the wildcards;  see
@@ -550,7 +550,7 @@ PostgreSQL documentation
         <replaceable class="parameter">pattern</replaceable> parameter is
         interpreted as a pattern according to the same rules used by
         <application>psql</application>'s <literal>\d</literal> commands
-        (see <xref linkend="app-psql-patterns"/> below),
+        (see <xref linkend="app-psql-patterns"/>),
         so multiple tables can also be selected by writing wildcard characters
         in the pattern.  When using wildcards, be careful to quote the pattern
         if needed to prevent the shell from expanding the wildcards;  see
@@ -801,7 +801,7 @@ PostgreSQL documentation
         Also, the <replaceable class="parameter">foreignserver</replaceable> parameter is
         interpreted as a pattern according to the same rules used by
         <application>psql</application>'s <literal>\d</literal> commands
-        (see <xref linkend="app-psql-patterns"/> below),
+        (see <xref linkend="app-psql-patterns"/>),
         so multiple foreign servers can also be selected by writing wildcard characters
         in the pattern.  When using wildcards, be careful to quote the pattern
         if needed to prevent the shell from expanding the wildcards; see
@@ -1521,7 +1521,7 @@ CREATE DATABASE foo WITH TEMPLATE template0;
   <para>
    To specify an upper-case or mixed-case name in <option>-t</option> and related
    switches, you need to double-quote the name; else it will be folded to
-   lower case (see <xref linkend="app-psql-patterns"/> below).  But
+   lower case (see <xref linkend="app-psql-patterns"/>).  But
    double quotes are special to the shell, so in turn they must be quoted.
    Thus, to dump a single table with a mixed-case name, you need something
    like
index 5d54074e0121f5a697c27c41a55a9f42496410cf..e62d05e5ab58016a5076683d08a4d171bd60d022 100644 (file)
@@ -301,7 +301,7 @@ PostgreSQL documentation
         <replaceable class="parameter">pattern</replaceable> parameter is
         interpreted as a pattern according to the same rules used by
         <application>psql</application>'s <literal>\d</literal>
-        commands (see <xref linkend="app-psql-patterns"/> below),
+        commands (see <xref linkend="app-psql-patterns"/>),
         so multiple databases can also be excluded by writing wildcard
         characters in the pattern.  When using wildcards, be careful to
         quote the pattern if needed to prevent shell wildcard expansion.