summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruce Momjian2023-05-19 02:22:17 +0000
committerBruce Momjian2023-05-19 02:22:17 +0000
commitce3673daded3fe3a101b0c008235dcf8bfe9ffec (patch)
treecb2e80783a295287b64614c052d0a69b4cbfd312
parentf79ee34702d485fb30427816b95e6c944660fc23 (diff)
doc: improve description of adding roles as members
Discussion: https://postgr.es/m/[email protected]
-rw-r--r--doc/src/sgml/ref/create_role.sgml15
-rw-r--r--doc/src/sgml/ref/createuser.sgml22
2 files changed, 18 insertions, 19 deletions
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!
<term><literal>IN ROLE</literal> <replaceable class="parameter">role_name</replaceable></term>
<listitem>
<para>
- The <literal>IN ROLE</literal> 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 <command>GRANT</command> command to do that.)
+ The <literal>IN ROLE</literal> 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 <command>GRANT</command> command
+ to do that.)
</para>
</listitem>
</varlistentry>
@@ -306,9 +307,9 @@ in sync when changing the above synopsis!
<term><literal>ROLE</literal> <replaceable class="parameter">role_name</replaceable></term>
<listitem>
<para>
- The <literal>ROLE</literal> 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 <quote>group</quote>.)
+ The <literal>ROLE</literal> 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 <quote>group</quote>.
</para>
</listitem>
</varlistentry>
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
<term><option>--admin=<replaceable class="parameter">role</replaceable></option></term>
<listitem>
<para>
- 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
- <option>-a</option> switches.
+ new role to others. Multiple existing roles can be specified by
+ writing multiple <option>-a</option> switches.
</para>
</listitem>
</varlistentry>
@@ -153,11 +152,10 @@ PostgreSQL documentation
<term><option>--role=<replaceable class="parameter">role</replaceable></option></term>
<listitem>
<para>
- 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
- <option>-g</option> switches.
- </para>
+ 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 <option>-g</option> switches.
+ </para>
</listitem>
</varlistentry>
@@ -227,9 +225,9 @@ PostgreSQL documentation
<term><option>--member=<replaceable class="parameter">role</replaceable></option></term>
<listitem>
<para>
- 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 <option>-m</option> 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 <option>-m</option> switches.
</para>
</listitem>
</varlistentry>