Information schema documentation

Add a sentence of documentation about the differences between the
*_privileges and the role_*_grants views.

diff --git a/doc/src/sgml/information_schema.sgml b/doc/src/sgml/information_schema.sgml
index adaacf03e4679c0a2a358c23ac2e39f36b5fba9d..64b28f7e61623df4071464c35d4fb03f8451d690 100644 (file)
--- a/doc/src/sgml/information_schema.sgml
+++ b/doc/src/sgml/information_schema.sgml
@@ -2843,7 +2843,11 @@ ORDER BY c.ordinal_position;
    The view <literal>role_column_grants</literal> identifies all
    privileges granted on columns where the grantor or grantee is a
    currently enabled role.  Further information can be found under
-   <literal>column_privileges</literal>.
+   <literal>column_privileges</literal>.  The only effective
+   difference between this view
+   and <literal>column_privileges</literal> is that this view omits
+   columns that have been made accessible to the current user by way
+   of a grant to public.
   </para>
 
   <table>
@@ -2922,7 +2926,11 @@ ORDER BY c.ordinal_position;
    The view <literal>role_routine_grants</literal> identifies all
    privileges granted on functions where the grantor or grantee is a
    currently enabled role.  Further information can be found under
-   <literal>routine_privileges</literal>.
+   <literal>routine_privileges</literal>.  The only effective
+   difference between this view
+   and <literal>routine_privileges</literal> is that this view omits
+   functions that have been made accessible to the current user by way
+   of a grant to public.
   </para>
 
   <table>
@@ -3012,7 +3020,11 @@ ORDER BY c.ordinal_position;
    The view <literal>role_table_grants</literal> identifies all
    privileges granted on tables or views where the grantor or grantee
    is a currently enabled role.  Further information can be found
-   under <literal>table_privileges</literal>.
+   under <literal>table_privileges</literal>.  The only effective
+   difference between this view
+   and <literal>table_privileges</literal> is that this view omits
+   tables that have been made accessible to the current user by way of
+   a grant to public.
   </para>
 
   <table>
@@ -3093,7 +3105,10 @@ ORDER BY c.ordinal_position;
    <literal>USAGE</literal> privileges granted on various kinds of
    objects where the grantor or grantee is a currently enabled role.
    Further information can be found under
-   <literal>usage_privileges</literal>.
+   <literal>usage_privileges</literal>.  The only effective difference
+   between this view and <literal>usage_privileges</literal> is that
+   this view omits objects that have been made accessible to the
+   current user by way of a grant to public.
   </para>
 
   <table>