commit 4344e620620fa82d89bc9838d389cc345a7763ea Author: Ian Barwick Date: Tue Oct 6 21:40:37 2020 +0900 doc: clarify behaviour of pg_dump's -t/--table option The existing wording gives the impression it might be possible to dump the contents of views, which is not possible. Also, from PostgreSQL 13 it is possible to dump the contents of foreign tables, but this requires the --include-foreign-data option. diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index f99dc3f31e..0aa35cf0c3 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -517,9 +517,7 @@ PostgreSQL documentation Dump only tables with names matching - pattern. - For this purpose, table includes views, materialized views, - sequences, and foreign tables. Multiple tables + pattern. Multiple tables can be selected by writing multiple switches. The pattern parameter is interpreted as a pattern according to the same rules used by @@ -531,6 +529,14 @@ PostgreSQL documentation below. + + As well as tables, this option can be used to dump the definition of matching + views, materialized views, foreign tables, and sequences. It will not dump the + contents of views or materialized views, and the contents of foreign tables will + only be dumped if the corresponding foreign server is specified with + . + + The and switches have no effect when is used, because tables selected by will