aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2020-02-09 14:20:26 -0500
committerTom Lane <tgl@sss.pgh.pa.us>2020-02-09 14:20:26 -0500
commit2db27ff4eb3afde142554e51675c82469f15ce71 (patch)
tree2caa5878fd2721e0ee0826b91398a6e0ab05e53f
parent0522d6f8f0d08b17f55b1e93e4a67e5f82e6bdaf (diff)
downloadpostgresql-2db27ff4eb3afde142554e51675c82469f15ce71.tar.gz
postgresql-2db27ff4eb3afde142554e51675c82469f15ce71.zip
Revert "docs: change "default role" wording to "predefined role""
This reverts commit 29af9c542f6cdc9a6456b175fdcdfe7a28b77d6c. Per discussion, we can't change the section title without some web-site work, so revert this change temporarily. Discussion: https://postgr.es/m/157742545062.1149.11052653770497832538@wrigleys.postgresql.org
-rw-r--r--doc/src/sgml/monitoring.sgml2
-rw-r--r--doc/src/sgml/user-manag.sgml28
2 files changed, 15 insertions, 15 deletions
diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index c38d50d5988..d18b271a58d 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -277,7 +277,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
existence of a session and its general properties such as its sessions user
and database are visible to all users. Superusers and members of the
built-in role <literal>pg_read_all_stats</literal> (see also <xref
- linkend="predefined-roles"/>) can see all the information about all sessions.
+ linkend="default-roles"/>) can see all the information about all sessions.
</para>
<table id="monitoring-stats-dynamic-views-table">
diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml
index 4432ee266b6..66f162703dd 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="predefined-roles">
- <title>Predefined Roles</title>
+ <sect1 id="default-roles">
+ <title>Default Roles</title>
- <indexterm zone="predefined-roles">
+ <indexterm zone="default-roles">
<primary>role</primary>
</indexterm>
<para>
- <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.
+ <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.
</para>
<para>
- The predefined roles are described in <xref linkend="predefined-roles-table"/>.
- Note that the specific permissions for each of the predefined roles may
+ The default roles are described in <xref linkend="default-roles-table"/>.
+ Note that the specific permissions for each of the default roles may
change in the future as additional capabilities are added. Administrators
should monitor the release notes for changes.
</para>
- <table tocentry="1" id="predefined-roles-table">
- <title>Predefined Roles</title>
+ <table tocentry="1" id="default-roles-table">
+ <title>Default 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 configuration settings, statistics, and other
- system information normally restricted to superusers.
+ allowing the role to read various useful configuration settings, statistics and
+ other system information normally restricted to superusers.
</para>
<para>