Doc: fix old oversights in GRANT/REVOKE documentation.
authorTom Lane <tgl@sss.pgh.pa.us>
Wed, 12 Feb 2020 19:13:13 +0000 (14:13 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 12 Feb 2020 19:13:13 +0000 (14:13 -0500)
commit2b9d4ec1d3c0da473232a9c1b065b976e3a2d13e
treecc655ec1ffed1a2209002f2bbf76936cff898cde
parent221c6baaff08802c18e35c648658c4e13d1b0e0a
Doc: fix old oversights in GRANT/REVOKE documentation.

The GRANTED BY clause in GRANT/REVOKE ROLE has been there since 2005
but was never documented.  I'm not sure now whether that was just an
oversight or was intentional (given the limited capability of the
option).  But seeing that pg_dumpall does emit code that uses this
option, it seems like not documenting it at all is a bad idea.

Also, when we upgraded the syntax to allow CURRENT_USER/SESSION_USER
as the privilege recipient, the role form of GRANT was incorrectly
not modified to show that, and REVOKE's docs weren't touched at all.

Although I'm not that excited about GRANTED BY, the other oversight
seems serious enough to justify a back-patch.

Discussion: http://postgr.es/m/3070.1581526786@sss.pgh.pa.us
doc/src/sgml/ref/grant.sgml
doc/src/sgml/ref/revoke.sgml