Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 0e936a2

Browse files
committed
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
1 parent 344c269 commit 0e936a2

File tree

2 files changed

+15
-15
lines changed

2 files changed

+15
-15
lines changed

doc/src/sgml/monitoring.sgml

+1-1
Original file line numberDiff line numberDiff line change
@@ -277,7 +277,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
277277
existence of a session and its general properties such as its sessions user
278278
and database are visible to all users. Superusers and members of the
279279
built-in role <literal>pg_read_all_stats</literal> (see also <xref
280-
linkend="default-roles"/>) can see all the information about all sessions.
280+
linkend="predefined-roles"/>) can see all the information about all sessions.
281281
</para>
282282

283283
<table id="monitoring-stats-dynamic-views-table">

doc/src/sgml/user-manag.sgml

+14-14
Original file line numberDiff line numberDiff line change
@@ -483,30 +483,30 @@ DROP ROLE doomed_role;
483483
</para>
484484
</sect1>
485485

486-
<sect1 id="default-roles">
487-
<title>Default Roles</title>
486+
<sect1 id="predefined-roles">
487+
<title>Predefined Roles</title>
488488

489-
<indexterm zone="default-roles">
489+
<indexterm zone="predefined-roles">
490490
<primary>role</primary>
491491
</indexterm>
492492

493493
<para>
494-
<productname>PostgreSQL</productname> provides a set of default roles
495-
which provide access to certain, commonly needed, privileged capabilities
496-
and information. Administrators can GRANT these roles to users and/or
497-
other roles in their environment, providing those users with access to
498-
the specified capabilities and information.
494+
<productname>PostgreSQL</productname> provides a set of predefined
495+
roles which allow access to privileged capabilities and information.
496+
Administrators can GRANT these roles to login and non-login roles,
497+
providing those roles with access to the specified capabilities and
498+
information.
499499
</para>
500500

501501
<para>
502-
The default roles are described in <xref linkend="default-roles-table"/>.
503-
Note that the specific permissions for each of the default roles may
502+
The predefined roles are described in <xref linkend="predefined-roles-table"/>.
503+
Note that the specific permissions for each of the predefined roles may
504504
change in the future as additional capabilities are added. Administrators
505505
should monitor the release notes for changes.
506506
</para>
507507

508-
<table tocentry="1" id="default-roles-table">
509-
<title>Default Roles</title>
508+
<table tocentry="1" id="predefined-roles-table">
509+
<title>Predefined Roles</title>
510510
<tgroup cols="2">
511511
<thead>
512512
<row>
@@ -565,8 +565,8 @@ DROP ROLE doomed_role;
565565
<literal>pg_read_all_stats</literal> and <literal>pg_stat_scan_tables</literal>
566566
roles are intended to allow administrators to easily configure a role for the
567567
purpose of monitoring the database server. They grant a set of common privileges
568-
allowing the role to read various useful configuration settings, statistics and
569-
other system information normally restricted to superusers.
568+
allowing the role to read configuration settings, statistics, and other
569+
system information normally restricted to superusers.
570570
</para>
571571

572572
<para>

0 commit comments

Comments
 (0)