Updated documentation for default privileges to clarify more on the grantor. Fixes #4659.

docs/en_US/database_dialog.rst

@@ -61,8 +61,7 @@ Use the *Privileges* panel to assign privileges to a role. Click the *Add* icon
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the database.
 
 Click add to set additional privileges; to discard a privilege, click the trash
 icon to the left of the row and confirm deletion in the *Delete Row* popup.
@@ -121,4 +120,3 @@ allows unlimited connections, and is available to all authenticated users.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-

docs/en_US/foreign_data_wrapper_dialog.rst

@@ -75,9 +75,7 @@ to assign a set of privileges.
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privileges to the specified user.
-* Select the name of the role granting the privileges from the drop-down listbox
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  in the *Grantor* field. The default grantor is the owner of the foreign data
-  wrapper.
 
 Click add to assign additional privileges; to discard a privilege, click the
 trash icon to the left of the row and confirm deletion in the *Delete Row*
@@ -108,5 +106,3 @@ pre-existing validator and handler functions, *dblink_fdw_validator* and
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-

docs/en_US/foreign_server_dialog.rst

@@ -65,9 +65,7 @@ Click *Add* before you assign a set of privileges.
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privileges to the specified user.
-* Select the name of the role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the foreign server. This is a required
-  field.
 
 Click *Add* to assign a new set of privileges; to discard a privilege, click the
 trash icon to the left of the row and confirm deletion in the *Delete Row*

docs/en_US/foreign_table_dialog.rst

@@ -120,9 +120,7 @@ Use the *Privileges* panel to assign privileges to a role. Click the *Add* icon
   drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role that owns the foreign table from the drop-down
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  listbox in the *Grantor* field. The default grantor is the owner of the
-  database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in
@@ -166,5 +164,3 @@ columns and two options.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-

docs/en_US/function_dialog.rst

@@ -140,8 +140,7 @@ role.
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in
@@ -184,6 +183,3 @@ function have three columns (p_ename, p_sal and p_comm).
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-
-

docs/en_US/grant_wizard.rst

@@ -55,8 +55,7 @@ the object.
   more privileges to grant the selected privileges to the specified user. If
   privileges have previously been granted on a database object, unchecking a
   privilege for a group or user will result in revoking that privilege.
-* If enabled, select the name of the role from the drop-down listbox in the
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  *Grantor* field. The default grantor is the owner of the database.
 * Click the *Add* icon (+) to assign a set of privileges to another role; to
   discard a privilege, click the trash icon to the left of the row and confirm
   deletion in the *Delete Row* dialog.
@@ -89,4 +88,4 @@ privileges *WITH GRANT OPTION* on the *sales_meetings* and the
 * Click the *Back* button to select or deselect additional database objects,
   roles and privileges.
 * Click the *Cancel* button to exit without saving work.
-* Click the *Finish* button to save selections and exit the wizard.
+* Click the *Finish* button to save selections and exit the wizard.

docs/en_US/language_dialog.rst

@@ -53,8 +53,7 @@ Use the *Privileges* panel to assign privileges to a role. Click the *Add* icon
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in
@@ -96,5 +95,3 @@ The example shown demonstrates creating the procedural language named *plperl*.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-

docs/en_US/materialized_view_dialog.rst

@@ -83,8 +83,7 @@ Use the *Privileges* panel to assign privileges to a role. Click the *Add* icon
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role from the drop-down listbox in the *Grantor*
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  field. The default grantor is the owner of the database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in

docs/en_US/package_dialog.rst

@@ -51,8 +51,7 @@ package to a role. Click the *Add* icon (+) to set privileges for the package:
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of a
   privilege to grant the selected privilege to the specified user.
-* Select the name of a role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the package.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row, and confirm the deletion
@@ -73,5 +72,3 @@ two function and two procedure.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to delete any changes to the dialog.
-
-

docs/en_US/procedure_dialog.rst

@@ -122,8 +122,7 @@ role:
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the database.
 
 Click *Add* to assign additional privileges; to discard a privilege, click the
 trash icon to the left of the row and confirm deletion in the *Delete Row*
@@ -166,4 +165,4 @@ with the privileges of the role that defined the procedure.
 * Click the *Info* button (i) to access online help.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
-* Click the *Reset* button to restore configuration parameters.
+* Click the *Reset* button to restore configuration parameters.

docs/en_US/release_notes_4_16.rst

@@ -20,6 +20,7 @@ Bug fixes
 *********
 
 | `Issue #3538 <https://redmine.postgresql.org/issues/3538>`_ - Fix issue where the Reset button does not get enabled till all the mandatory fields are provided in the dialog.
+| `Issue #4659 <https://redmine.postgresql.org/issues/4659>`_ - Updated documentation for default privileges to clarify more on the grantor.
 | `Issue #4792 <https://redmine.postgresql.org/issues/4792>`_ - Ensure that the superuser should be able to create database, as the superuser overrides all the access restrictions.
 | `Issue #4836 <https://redmine.postgresql.org/issues/4836>`_ - Updated the json file name from 'servers.json' to 'pgadmin4/servers.json' in the container deployment section of the documentation.
 | `Issue #4878 <https://redmine.postgresql.org/issues/4878>`_ - Ensure that the superuser should be able to create role, as the superuser overrides all the access restrictions.

docs/en_US/schema_dialog.rst

@@ -38,9 +38,7 @@ panel:
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privileges to the specified user.
-* Select the name of the role that is granting the privilege from the drop-down
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  listbox in the *Grantor* field. The default grantor is the owner of the
-  schema.
 
 Click the *Add* icon (+) to assign additional sets of privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in
@@ -75,8 +73,7 @@ privileges:
   the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privileges to the specified user.
-* Select the name of the role that is granting the privilege from the drop-down
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  listbox in the *Grantor* field. The default grantor is the owner of the schema.
 
 Click the *SQL* tab to continue.
 
@@ -101,6 +98,3 @@ The example creates a schema named hr; the command grants *USAGE* privileges to
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-
-

docs/en_US/sequence_dialog.rst

@@ -73,8 +73,7 @@ set privileges:
   listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role from the drop-down listbox in the *Grantor*
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  field. The default grantor is the owner of the database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in
@@ -118,9 +117,3 @@ equal of *60*.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-
-
-
-
-

docs/en_US/table_dialog.rst

@@ -482,8 +482,7 @@ Use the *Privileges* panel to assign privileges to a role. Click the *Add* icon
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in

docs/en_US/tablespace_dialog.rst

@@ -62,8 +62,7 @@ Use the *Privileges* panel to assign security privileges. Click the *Add* icon
 (+) to assign a set of privileges:
 
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
-* Select the name of the role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the owner of the tablespace.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privileges to the specified user.
 
@@ -107,6 +106,3 @@ The example shown demonstrates creating a tablespace named *space_01*. It has a
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-
-

docs/en_US/trigger_function_dialog.rst

@@ -128,8 +128,7 @@ to a role. Click the *Add* icon (+) to to add a role to the table.
 * Select the name of the role from the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of a role from the drop-down listbox in the *Grantor* field.
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  The default grantor is the owner of the database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in
@@ -171,5 +170,3 @@ The example shown demonstrates creating a trigger function named *emp_stamp*.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-

docs/en_US/type_dialog.rst

@@ -187,9 +187,7 @@ icon (+) to grant privileges:
   the drop-down listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of the role that is granting privileges from the drop-down
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  listbox in the *Grantor* field. The default grantor is the owner of the
-  database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in
@@ -232,6 +230,3 @@ type is an enumerated type with three labels: new, open and closed.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-
-

docs/en_US/view_dialog.rst

@@ -72,9 +72,7 @@ Use the *Privileges* panel to assign privileges to a role. Click the *Add* icon
   listbox in the *Grantee* field.
 * Click inside the *Privileges* field. Check the boxes to the left of one or
   more privileges to grant the selected privilege to the specified user.
-* Select the name of a role with sufficient privileges to grant privileges on
+* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* field.
-  the view from the drop-down listbox in the *Grantor* field. The default
-  grantor is the owner of the database.
 
 Click the *Add* icon (+) to assign additional privileges; to discard a
 privilege, click the trash icon to the left of the row and confirm deletion in
@@ -116,6 +114,3 @@ The example shown demonstrates creating a view named *distributor_code*.
 * Click the *Save* button to save work.
 * Click the *Cancel* button to exit without saving work.
 * Click the *Reset* button to restore configuration parameters.
-
-
-