Commit 0e936a21 authored by Bruce Momjian's avatar Bruce Momjian

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
parent 344c2691
...@@ -277,7 +277,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser ...@@ -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">
......
...@@ -483,30 +483,30 @@ DROP ROLE doomed_role; ...@@ -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; ...@@ -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>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment