postgres.git / summary / log / commit / refs

commit    d89755dac6153518a601ca0fa9e489f2bc209fdc
Author:   Tom Lane <tgl@sss.pgh.pa.us>
Date:     Fri Sep 23 02:05:09 2022 +0000
First released in: 16.0

    Doc: adjust misleading phrasing of a few cross-references.
    
    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 | 8 ++++---- doc/src/sgml/ref/pg_dumpall.sgml | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index c08276bc0aa..8b9d9f4cad4 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -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 diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml index 5d54074e012..e62d05e5ab5 100644 --- a/doc/src/sgml/ref/pg_dumpall.sgml +++ b/doc/src/sgml/ref/pg_dumpall.sgml @@ -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. [parent: 20e69daa1348]