diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 374bca66a0a..023d82b2ef2 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -168,11 +168,12 @@ PostgreSQL documentation
- Output commands to clean (drop)
+ Output commands to DROP all the dumped
database objects prior to outputting the commands for creating them.
- (Unless is also specified,
- restore might generate some harmless error messages, if any objects
- were not present in the destination database.)
+ This option is useful when the restore is to overwrite an existing
+ database. If any of the objects do not exist in the destination
+ database, ignorable error messages will be reported during
+ restore, unless is also specified.
@@ -764,9 +765,11 @@ PostgreSQL documentation
- Use conditional commands (i.e., add an IF EXISTS
- clause) when cleaning database objects. This option is not valid
- unless is also specified.
+ Use DROP ... IF EXISTS commands to drop objects
+ in mode. This suppresses does not
+ exist errors that might otherwise be reported. This
+ option is not valid unless is also
+ specified.
diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml
index e57f119bad6..2f0f7b78bc5 100644
--- a/doc/src/sgml/ref/pg_dumpall.sgml
+++ b/doc/src/sgml/ref/pg_dumpall.sgml
@@ -90,9 +90,12 @@ PostgreSQL documentation
- Include SQL commands to clean (drop) databases before
- recreating them. DROP commands for roles and
- tablespaces are added as well.
+ Emit SQL commands to DROP all the dumped
+ databases, roles, and tablespaces before recreating them.
+ This option is useful when the restore is to overwrite an existing
+ cluster. If any of the objects do not exist in the destination
+ cluster, ignorable error messages will be reported during
+ restore, unless is also specified.
@@ -321,9 +324,11 @@ PostgreSQL documentation
- Use conditional commands (i.e., add an IF EXISTS
- clause) to drop databases and other objects. This option is not valid
- unless is also specified.
+ Use DROP ... IF EXISTS commands to drop objects
+ in mode. This suppresses does not
+ exist errors that might otherwise be reported. This
+ option is not valid unless is also
+ specified.
diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index 7249a5e8336..f8e7351b82b 100644
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -111,10 +111,12 @@ PostgreSQL documentation
- Clean (drop) database objects before recreating them.
- (Unless is used,
- this might generate some harmless error messages, if any objects
- were not present in the destination database.)
+ Before restoring database objects, issue commands
+ to DROP all the objects that will be restored.
+ This option is useful for overwriting an existing database.
+ If any of the objects do not exist in the destination database,
+ ignorable error messages will be reported,
+ unless is also specified.
@@ -575,9 +577,11 @@ PostgreSQL documentation
- Use conditional commands (i.e., add an IF EXISTS
- clause) to drop database objects. This option is not valid
- unless is also specified.
+ Use DROP ... IF EXISTS commands to drop objects
+ in mode. This suppresses does not
+ exist errors that might otherwise be reported. This
+ option is not valid unless is also
+ specified.