clarify --no-comments option in --help and SGML files

The previous commit, b38bac26e20, missed these cases for dump/restore.

Reported-by: Tom Lane
Discussion: https://postgr.es/m/3495698.1731968093@sss.pgh.pa.us

Backpatch-through: master

diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml
index 4d7c0464687ef6e0e1443a588ba39b0ae38c4f03..014f2792589a633d69804a184c6eb7c821d71dc9 100644 (file)
--- a/doc/src/sgml/ref/pg_dumpall.sgml
+++ b/doc/src/sgml/ref/pg_dumpall.sgml
@@ -417,7 +417,7 @@ exclude database <replaceable class="parameter">PATTERN</replaceable>
       <term><option>--no-comments</option></term>
       <listitem>
        <para>
-        Do not dump comments.
+        Do not dump <command>COMMENT</command> commands.
        </para>
       </listitem>
      </varlistentry>

diff --git a/src/bin/pg_dump/pg_dump.c b/src/bin/pg_dump/pg_dump.c
index a8c141b689df474d78d0e92cfbaa1d1bc98de4a1..c30aafbe70d1b3987cd157116511f3653343d998 100644 (file)
--- a/src/bin/pg_dump/pg_dump.c
+++ b/src/bin/pg_dump/pg_dump.c
@@ -1212,7 +1212,7 @@ help(const char *progname)
                         "                               servers matching PATTERN\n"));
        printf(_("  --inserts                    dump data as INSERT commands, rather than COPY\n"));
        printf(_("  --load-via-partition-root    load partitions via the root table\n"));
-       printf(_("  --no-comments                do not dump comments\n"));
+       printf(_("  --no-comments                do not dump comment commands\n"));
        printf(_("  --no-publications            do not dump publications\n"));
        printf(_("  --no-security-labels         do not dump security label assignments\n"));
        printf(_("  --no-subscriptions           do not dump subscriptions\n"));

diff --git a/src/bin/pg_dump/pg_dumpall.c b/src/bin/pg_dump/pg_dumpall.c
index e3ad8fb295683bce66a9c1a5715de5f8a27d0544..9a04e51c81a43198eeca8c68a77ec776795a0477 100644 (file)
--- a/src/bin/pg_dump/pg_dumpall.c
+++ b/src/bin/pg_dump/pg_dumpall.c
@@ -662,7 +662,7 @@ help(void)
        printf(_("  --if-exists                  use IF EXISTS when dropping objects\n"));
        printf(_("  --inserts                    dump data as INSERT commands, rather than COPY\n"));
        printf(_("  --load-via-partition-root    load partitions via the root table\n"));
-       printf(_("  --no-comments                do not dump comments\n"));
+       printf(_("  --no-comments                do not dump comment commands\n"));
        printf(_("  --no-publications            do not dump publications\n"));
        printf(_("  --no-role-passwords          do not dump passwords for roles\n"));
        printf(_("  --no-security-labels         do not dump security label assignments\n"));

diff --git a/src/bin/pg_dump/pg_restore.c b/src/bin/pg_dump/pg_restore.c
index f2c1020d0531e9510eae89fa48df8e05455491b0..10da7d27da8147a790341f0b95dbdf0ccc851718 100644 (file)
--- a/src/bin/pg_dump/pg_restore.c
+++ b/src/bin/pg_dump/pg_restore.c
@@ -484,7 +484,7 @@ usage(const char *progname)
        printf(_("  --filter=FILENAME            restore or skip objects based on expressions\n"
                         "                               in FILENAME\n"));
        printf(_("  --if-exists                  use IF EXISTS when dropping objects\n"));
-       printf(_("  --no-comments                do not restore comments\n"));
+       printf(_("  --no-comments                do not restore comment commands\n"));
        printf(_("  --no-data-for-failed-tables  do not restore data of tables that could not be\n"
                         "                               created\n"));
        printf(_("  --no-publications            do not restore publications\n"));