Clarify documentation around pg_dump -t option

The behavior is different for different types of objects, so make that
more clear.

Author: Ian Barwick

diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 3e48498db28fac2c8ae176d4150f2564ac7b2dc5..478686e15dad57e9bc3ec89c2546a2d15ed185c7 100644 (file)
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -516,9 +516,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 -t switches.  The
         pattern parameter is
         interpreted as a pattern according to the same rules used by
@@ -530,6 +528,14 @@ PostgreSQL documentation
          below.
        
 
+       
+        As well as tables, this option can be used to dump views, materialized views,
+        foreign tables, and sequence definitions.  However 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
+        --include-foreign-data.
+       
+
        
         The -n and -N switches have no effect when
         -t is used, because tables selected by -t will