summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2020-01-14 13:13:04 -0500
committerBruce Momjian <bruce@momjian.us>2020-01-14 13:13:04 -0500
commit749f702d13de750b0adaf0aedbcc3c01f078c0c2 (patch)
treea35093120eaab09ebc66113dfe4633eb01e9172d
parent9bdb1f0e37d4f65cdc32cec1563744dc92213d71 (diff)
docs: change "default role" wording to "predefined role"
The new wording was determined to be more accurate. Also, update release note links that reference these sections. Reported-by: rirans@comcast.net Discussion: https://postgr.es/m/157742545062.1149.11052653770497832538@wrigleys.postgresql.org Backpatch-through: 9.6
-rw-r--r--doc/src/sgml/release-11.sgml2
-rw-r--r--doc/src/sgml/user-manag.sgml28
2 files changed, 15 insertions, 15 deletions
diff --git a/doc/src/sgml/release-11.sgml b/doc/src/sgml/release-11.sgml
index 5c43fc4de2c..6be615f04a3 100644
--- a/doc/src/sgml/release-11.sgml
+++ b/doc/src/sgml/release-11.sgml
@@ -7592,7 +7592,7 @@ same commits as above
-->
<para>
- Add <link linkend="default-roles-table">default roles</link> that
+ Add <link linkend="predefined-roles-table">default roles</link> that
enable file system access (Stephen Frost)
</para>
diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml
index 66f162703dd..4432ee266b6 100644
--- a/doc/src/sgml/user-manag.sgml
+++ b/doc/src/sgml/user-manag.sgml
@@ -483,30 +483,30 @@ DROP ROLE doomed_role;
</para>
</sect1>
- <sect1 id="default-roles">
- <title>Default Roles</title>
+ <sect1 id="predefined-roles">
+ <title>Predefined Roles</title>
- <indexterm zone="default-roles">
+ <indexterm zone="predefined-roles">
<primary>role</primary>
</indexterm>
<para>
- <productname>PostgreSQL</productname> provides a set of default roles
- which provide access to certain, commonly needed, privileged capabilities
- and information. Administrators can GRANT these roles to users and/or
- other roles in their environment, providing those users with access to
- the specified capabilities and information.
+ <productname>PostgreSQL</productname> provides a set of predefined
+ roles which allow access to privileged capabilities and information.
+ Administrators can GRANT these roles to login and non-login roles,
+ providing those roles with access to the specified capabilities and
+ information.
</para>
<para>
- The default roles are described in <xref linkend="default-roles-table"/>.
- Note that the specific permissions for each of the default roles may
+ The predefined roles are described in <xref linkend="predefined-roles-table"/>.
+ Note that the specific permissions for each of the predefined roles may
change in the future as additional capabilities are added. Administrators
should monitor the release notes for changes.
</para>
- <table tocentry="1" id="default-roles-table">
- <title>Default Roles</title>
+ <table tocentry="1" id="predefined-roles-table">
+ <title>Predefined Roles</title>
<tgroup cols="2">
<thead>
<row>
@@ -565,8 +565,8 @@ DROP ROLE doomed_role;
<literal>pg_read_all_stats</literal> and <literal>pg_stat_scan_tables</literal>
roles are intended to allow administrators to easily configure a role for the
purpose of monitoring the database server. They grant a set of common privileges
- allowing the role to read various useful configuration settings, statistics and
- other system information normally restricted to superusers.
+ allowing the role to read configuration settings, statistics, and other
+ system information normally restricted to superusers.
</para>
<para>