diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index c1e2220b3c..625a736eff 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -170,11 +170,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.
@@ -839,9 +840,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 e219a79858..d31585216c 100644
--- a/doc/src/sgml/ref/pg_dumpall.sgml
+++ b/doc/src/sgml/ref/pg_dumpall.sgml
@@ -91,9 +91,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.
@@ -324,9 +327,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 47bd7dbda0..a81583191c 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.
@@ -580,9 +582,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.