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
This commit is contained in:
Bruce Momjian 2020-01-14 13:13:04 -05:00
parent 344c269151
commit 0e936a2148
2 changed files with 15 additions and 15 deletions

View File

@ -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="default-roles"/>) can see all the information about all sessions.
linkend="predefined-roles"/>) can see all the information about all sessions.
</para>
<table id="monitoring-stats-dynamic-views-table">

View File

@ -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>