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 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 and database are visible to all users. Superusers and members of the
built-in role <literal>pg_read_all_stats</literal> (see also <xref 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> </para>
<table id="monitoring-stats-dynamic-views-table"> <table id="monitoring-stats-dynamic-views-table">

View File

@ -483,30 +483,30 @@ DROP ROLE doomed_role;
</para> </para>
</sect1> </sect1>
<sect1 id="default-roles"> <sect1 id="predefined-roles">
<title>Default Roles</title> <title>Predefined Roles</title>
<indexterm zone="default-roles"> <indexterm zone="predefined-roles">
<primary>role</primary> <primary>role</primary>
</indexterm> </indexterm>
<para> <para>
<productname>PostgreSQL</productname> provides a set of default roles <productname>PostgreSQL</productname> provides a set of predefined
which provide access to certain, commonly needed, privileged capabilities roles which allow access to privileged capabilities and information.
and information. Administrators can GRANT these roles to users and/or Administrators can GRANT these roles to login and non-login roles,
other roles in their environment, providing those users with access to providing those roles with access to the specified capabilities and
the specified capabilities and information. information.
</para> </para>
<para> <para>
The default roles are described in <xref linkend="default-roles-table"/>. The predefined roles are described in <xref linkend="predefined-roles-table"/>.
Note that the specific permissions for each of the default roles may Note that the specific permissions for each of the predefined roles may
change in the future as additional capabilities are added. Administrators change in the future as additional capabilities are added. Administrators
should monitor the release notes for changes. should monitor the release notes for changes.
</para> </para>
<table tocentry="1" id="default-roles-table"> <table tocentry="1" id="predefined-roles-table">
<title>Default Roles</title> <title>Predefined Roles</title>
<tgroup cols="2"> <tgroup cols="2">
<thead> <thead>
<row> <row>
@ -565,8 +565,8 @@ DROP ROLE doomed_role;
<literal>pg_read_all_stats</literal> and <literal>pg_stat_scan_tables</literal> <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 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 purpose of monitoring the database server. They grant a set of common privileges
allowing the role to read various useful configuration settings, statistics and allowing the role to read configuration settings, statistics, and other
other system information normally restricted to superusers. system information normally restricted to superusers.
</para> </para>
<para> <para>