diff --git a/doc/src/sgml/ref/create_role.sgml b/doc/src/sgml/ref/create_role.sgml
index 4a84461b286..7249fc74324 100644
--- a/doc/src/sgml/ref/create_role.sgml
+++ b/doc/src/sgml/ref/create_role.sgml
@@ -285,10 +285,11 @@ in sync when changing the above synopsis!
IN ROLErole_name
- The IN ROLE clause lists one or more existing
- roles to which the new role will be immediately added as a new
- member. (Note that there is no option to add the new role as an
- administrator; use a separate GRANT command to do that.)
+ The IN ROLE clause causes the new role to
+ be automatically added as a member of the specified existing
+ roles. (Note that there is no option to add the new role as an
+ administrator; use a separate GRANT command
+ to do that.)
@@ -306,9 +307,9 @@ in sync when changing the above synopsis!
ROLErole_name
- The ROLE clause lists one or more existing
- roles which are automatically added as members of the new role.
- (This in effect makes the new role a group.)
+ The ROLE clause causes one or more specified
+ existing roles to be automatically added as members of the new
+ role. This in effect makes the new role a group.
diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml
index c5c74b86a20..58ed1116420 100644
--- a/doc/src/sgml/ref/createuser.sgml
+++ b/doc/src/sgml/ref/createuser.sgml
@@ -85,11 +85,10 @@ PostgreSQL documentation
- Indicates a role that will be immediately added as a member of the new
+ Indicates an existing role that will be automatically added as a member of the new
role with admin option, giving it the right to grant membership in the
- new role to others. Multiple roles to add as members (with admin
- option) of the new role can be specified by writing multiple
- switches.
+ new role to others. Multiple existing roles can be specified by
+ writing multiple switches.
@@ -153,11 +152,10 @@ PostgreSQL documentation
- Indicates a role to which this role will be added immediately as a new
- member. Multiple roles to which this role will be added as a member
- can be specified by writing multiple
- switches.
-
+ Indicates the new role should be automatically added as a member
+ of the specified existing role. Multiple existing roles can be
+ specified by writing multiple switches.
+
@@ -227,9 +225,9 @@ PostgreSQL documentation
- Indicates role that will be immediately added as a member of the new
- role. Multiple roles to add as members of the new role can be specified
- by writing multiple switches.
+ Indicates the specified existing role should be automatically
+ added as a member of the new role. Multiple existing roles can
+ be specified by writing multiple switches.