diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 7f538e90194..ae1bc14d2f2 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -1687,6 +1687,18 @@ CREATE DATABASE foo WITH TEMPLATE template0;
catalogs might be left in the wrong state.
+
+ When creating an archive (non-text) output file, it is advisable not to
+ restrict the set of database objects dumped, but instead plan to apply
+ any desired object filtering when reading the archive
+ with pg_restore. This will preserve
+ flexibility and possibly avoid problems at restore time; for details
+ see the documentation.
+ In particular, dumping table data without the corresponding table
+ definition (via and related options) is
+ not recommended.
+
+
When is specified,
pg_dump will include most optimizer statistics in the
diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index 9d91c365214..6ae2cdcfc10 100644
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -1215,6 +1215,22 @@ CREATE DATABASE foo WITH TEMPLATE template0;
+
+
+ Parallel restore ( greater than 1) requires
+ applying dependency information from the archive file to ensure
+ that an object is not restored before other objects it depends on.
+ This information will be incomplete, leading to unexpected restore
+ failures, if the archive does not include object definitions
+ (the section). Therefore, avoid
+ using pg_dump options such
+ as , ,
+ or without when
+ creating an archive you wish to restore in parallel. Instead, you
+ may provide such options to pg_restore.
+
+
+
pg_restore cannot restore large objects
selectively; for instance, only those for a specific table. If
@@ -1224,14 +1240,6 @@ CREATE DATABASE foo WITH TEMPLATE template0;
-
-
- When restoring from a non-plain-text archive made using
- pg_dumpall, the
- option may be used, but must include .
-
-
-
The following options cannot be used when restoring from a non-plain-text
@@ -1242,6 +1250,8 @@ CREATE DATABASE foo WITH TEMPLATE template0;
,
, and
.
+ Also, if the option is used, it must
+ include .