Document pg_ls_*dir hiding of directories and special files

It's strange that a directory-listing function does not list all entries
in a directory, so let's at least document it.  This involves

pg_ls_logdir
pg_ls_waldir
pg_ls_archive_statusdir
pg_ls_tmpdir

Backpatch as far back as it applies cleanly (and as far as as each
function exists).  REL_10_STABLE uses different wording, but hopefully
people are not reading docs so old to write new apps anyway.

Author: Justin Pryzby 
Discussion: https://postgr.es/m/20200305161838[email protected]

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 3fd67e606f1c07e9c2d85afcdb3f2ec4a39d82ed..652580a80422794525a1c3483ef781c3e1761034 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -20311,6 +20311,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
     (mtime) of each file in the log directory. By default, only superusers
     and members of the pg_monitor role can use this function.
     Access may be granted to others using GRANT.
+    Filenames beginning with a dot, directories, and other special files are not shown.
    
 
    
@@ -20322,6 +20323,7 @@ postgres=# SELECT * FROM pg_walfile_name_offset(pg_stop_backup());
     default only superusers and members of the pg_monitor role
     can use this function. Access may be granted to others using
     GRANT.
+    Filenames beginning with a dot, directories, and other special files are not shown.