diff --git a/doc/src/sgml/ref/grant.sgml b/doc/src/sgml/ref/grant.sgml index a43de6356d9..5aa40cb933d 100644 --- a/doc/src/sgml/ref/grant.sgml +++ b/doc/src/sgml/ref/grant.sgml @@ -1,5 +1,5 @@ @@ -104,10 +104,15 @@ GRANT { { CREATE | USAGE } [,...] | ALL [ PRIVILEGES ] } SELECT - Allows from any column of the - specified table, view, or sequence. Also allows the use of - TO. For sequences, this - privilege also allows the use of the currval function. + Allows from + any column of the specified table, view, or sequence. + Also allows the use of + TO. + This privilege is also needed to reference existing column values in + or + . + For sequences, this privilege also allows the use of the + currval function. @@ -116,8 +121,9 @@ GRANT { { CREATE | USAGE } [,...] | ALL [ PRIVILEGES ] } INSERT - Allows of a new row into the - specified table. Also allows FROM. + Allows of a new + row into the specified table. + Also allows FROM. @@ -126,10 +132,15 @@ GRANT { { CREATE | USAGE } [,...] | ALL [ PRIVILEGES ] } UPDATE - Allows of any column of the - specified table. SELECT ... FOR UPDATE - also requires this privilege (besides the - SELECT privilege). For sequences, this + Allows of any + column of the specified table. + (In practice, any nontrivial UPDATE command will require + SELECT privilege as well, since it must reference table + columns to determine which rows to update, and/or to compute new + values for columns.) + SELECT ... FOR UPDATE + also requires this privilege, in addition to the + SELECT privilege. For sequences, this privilege allows the use of the nextval and setval functions. @@ -140,8 +151,11 @@ GRANT { { CREATE | USAGE } [,...] | ALL [ PRIVILEGES ] } DELETE - Allows of a row from the - specified table. + Allows of a row + from the specified table. + (In practice, any nontrivial DELETE command will require + SELECT privilege as well, since it must reference table + columns to determine which rows to delete.) @@ -196,7 +210,7 @@ GRANT { { CREATE | USAGE } [,...] | ALL [ PRIVILEGES ] } TEMP - Allows temporary tables to be created while using the database. + Allows temporary tables to be created while using the specified database.