diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml
index f1eb3b279ed..3e5514fd436 100644
--- a/doc/src/sgml/client-auth.sgml
+++ b/doc/src/sgml/client-auth.sgml
@@ -984,8 +984,9 @@ local db1,db2,@demodbs all md5
the remainder of the field is treated as a regular expression.
(See for details of
PostgreSQL's regular expression syntax.) The regular
- expression can include a single capture, or parenthesized subexpression,
- which can then be referenced in the database-username
+ expression can include a single capture, or parenthesized subexpression.
+ The portion of the system user name that matched the capture can then
+ be referenced in the database-username
field as \1 (backslash-one). This allows the mapping of
multiple user names in a single line, which is particularly useful for
simple syntax substitutions. For example, these entries
@@ -1003,12 +1004,11 @@ mymap /^(.*)@otherdomain\.com$ guest
If the database-username field starts with
a slash (/), the remainder of the field is treated
- as a regular expression (see
- for details of PostgreSQL's regular
- expression syntax). It is not possible to use \1
- to use a capture from regular expression on
- system-username for a regular expression
- on database-username.
+ as a regular expression.
+ When the database-username field is a regular
+ expression, it is not possible to use \1 within it to
+ refer to a capture from the system-username
+ field.