Improve docs for pg_authid encryption description with better markup and

a mention of unencrypted passwords.

diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml
index ecedaccaf7088ccdce9bc1759f7d8f9f47773b59..09152e6c5cea295ee653dddec9d05c2ba91af8a5 100644 (file)
--- a/doc/src/sgml/catalogs.sgml
+++ b/doc/src/sgml/catalogs.sgml
@@ -1264,12 +1264,14 @@
       rolpassword
       text
       
-       Password (possibly encrypted); null if none.  If the password is
-       encrypted, this column will contain the string md5 followed by a
-       32-character hexadecimal MD5 hash.  The MD5 hash will be of the
-       user's password concatenated to their username (for example, if
-       user joe has password xyzzy, PostgreSQL will store
-       the md5 hash of xyzzyjoe).
+       Password (possibly encrypted); null if none.  If the password
+       is encrypted, this column will begin with the string md5
+       followed by a 32-character hexadecimal MD5 hash.  The MD5 hash
+       will be of the user's password concatenated to their username.
+       For example, if user joe has password xyzzy,
+       PostgreSQL will store the md5 hash of
+       xyzzyjoe.  A password that does not follow that
+       format is assumed to be unencrypted.