doc: Clarify what files pg_basebackup omits from data directory

diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml
index c37113cb35ba51b64485148ac856007a7ab15e73..3a2421bf458ffddacac0dfc26bfd2fee12b23f6f 100644 (file)
--- a/doc/src/sgml/protocol.sgml
+++ b/doc/src/sgml/protocol.sgml
@@ -1995,6 +1995,11 @@ The commands accepted in walsender mode are:
          postmaster.opts
         
        
+       
+        
+         various temporary files created during the operation of the PostgreSQL server
+        
+       
        
         
          pg_xlog, including subdirectories. If the backup is run
@@ -2003,6 +2008,18 @@ The commands accepted in walsender mode are:
          backup to work, not the rest of the contents.
         
        
+       
+        
+         pg_replslot is copied as an empty directory.
+        
+       
+       
+        
+         Files other than regular files and directories, such as symbolic
+         links and special device files, are skipped.  (Symbolic links
+         in pg_tblspc are maintained.)
+        
+       
       
       Owner, group and file mode are set if the underlying file system on
       the server supports it.

diff --git a/doc/src/sgml/ref/pg_basebackup.sgml b/doc/src/sgml/ref/pg_basebackup.sgml
index 97b0af987ab7536d136d565ac1ca9ea0e0f270bf..10c1743754cb046504f33afb4000d588e82a5575 100644 (file)
--- a/doc/src/sgml/ref/pg_basebackup.sgml
+++ b/doc/src/sgml/ref/pg_basebackup.sgml
@@ -571,8 +571,10 @@ PostgreSQL documentation
   
    The backup will include all files in the data directory and tablespaces,
    including the configuration files and any additional files placed in the
-   directory by third parties. Only regular files and directories are allowed
-   in the data directory, no symbolic links or special device files.
+   directory by third parties. But only regular files and directories are
+   copied.  Symbolic links (other than those used for tablespaces) and special
+   device files are skipped.  (See  for
+   the precise details.)