doc: Add note to pg_dump man page about pg_dumpall

petere · petere · commit a85054181b3e · 2015-06-13T21:45:56.000-04:00
suggested by Joshua Drake
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
@@ -45,6 +45,12 @@ PostgreSQL documentation
    accessing the database (readers or writers).
   </para>
 
+  <para>
+   <application>pg_dump</application> only dumps a single database.  To backup
+   global objects that are common to all databases in a cluster, such as roles
+   and tablespaces, use <xref linkend="app-pg-dumpall">.
+  </para>
+
   <para>
    Dumps can be output in script or archive file formats. Script
    dumps are plain-text files containing the SQL commands required
