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: [email protected]
Discussion: https://postgr.es/m/157742545062.1149.11052653770497832538@wrigleys.postgresql.org

Backpatch-through: 9.6

diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index dcb58115af7dce65497e83f2813a462101a182c1..136778cb8ab278fab19b86b5b02743687dc4c528 100644 (file)
--- 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 pg_read_all_stats (see also 
-   linkend="default-roles"/>) can see all the information about all sessions.
+   linkend="predefined-roles"/>) can see all the information about all sessions.
   
 
   


diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml

index 66f162703ddddc075fec796bf8d53821900cd297..4432ee266b6d20041fbc8709aff36cfabd657061 100644 (file)

--- a/doc/src/sgml/user-manag.sgml
+++ b/doc/src/sgml/user-manag.sgml
@@ -483,30 +483,30 @@ DROP ROLE doomed_role;
   
  
 
- default-roles">
-  <span class="marked">Default</span> Roles
+ predefined-roles">
+  <span class="marked">Predefined</span> Roles
 
-  default-roles">
+  predefined-roles">
    role
   
 
   
-   PostgreSQL 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.
+   PostgreSQL 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.
   
 
   
-   The default roles are described in -roles-table"/>.
-   Note that the specific permissions for each of the default roles may
+   The predefined roles are described in -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.
   
 
-   default-roles-table">
-    <span class="marked">Default</span> Roles
+   predefined-roles-table">
+    <span class="marked">Predefined</span> Roles
     
      
       
@@ -565,8 +565,8 @@ DROP ROLE doomed_role;
   pg_read_all_stats and pg_stat_scan_tables
   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.
   
 
   

diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml
index 66f162703ddddc075fec796bf8d53821900cd297..4432ee266b6d20041fbc8709aff36cfabd657061 100644 (file)
--- a/doc/src/sgml/user-manag.sgml
+++ b/doc/src/sgml/user-manag.sgml
@@ -483,30 +483,30 @@ DROP ROLE doomed_role;
   
  
 
- default-roles">
-  <span class="marked">Default</span> Roles
+ predefined-roles">
+  <span class="marked">Predefined</span> Roles
 
-  default-roles">
+  predefined-roles">
    role
   
 
   
-   PostgreSQL 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.
+   PostgreSQL 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.
   
 
   
-   The default roles are described in -roles-table"/>.
-   Note that the specific permissions for each of the default roles may
+   The predefined roles are described in -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.
   
 
-   default-roles-table">
-    <span class="marked">Default</span> Roles
+   predefined-roles-table">
+    <span class="marked">Predefined</span> Roles
     
      
       
@@ -565,8 +565,8 @@ DROP ROLE doomed_role;
   pg_read_all_stats and pg_stat_scan_tables
   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.