doc: Add note to pg_dump man page about pg_dumpall

suggested by Joshua Drake

diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index c78f71d9a7acb8551ceef4ca0ed3bf595cae1a5a..7c28bd2876ddd809db1749c25e3f0b916aa085df 100644 (file)
--- 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