pgsql: More documentation update for GRANT ... WITH SET OPTION.

More documentation update for GRANT ... WITH SET OPTION.

Update the reference pages for various ALTER commands that
mentioned that you must be a member of role that will be the
new owner to instead say that you must be able to SET ROLE
to the new owner. Update ddl.sgml's generate statement on this
topic along similar lines.

Likewise, update CREATE SCHEMA and CREATE DATABASE, which
have options to specify who will own the new objects, to say
that you must be able to SET ROLE to the role that will own
them.

Finally, update the documentation for the GRANT statement
itself with some general principles about how the SET option
works and how it can be used.

Patch by me, reviewed (but not fully endorsed) by Noah Misch.

Discussion: http://postgr.es/m/CA+TgmoZk6VB3DQ83+DO5P_HP=M9PQAh1yj-KgeV30uKefVaWDg@mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/3cdf7502f85c9e61913e05519f88580f008b8453

Modified Files
--------------
doc/src/sgml/ddl.sgml | 4 ++--
doc/src/sgml/ref/alter_aggregate.sgml | 7 ++++---
doc/src/sgml/ref/alter_collation.sgml | 7 ++++---
doc/src/sgml/ref/alter_conversion.sgml | 7 ++++---
doc/src/sgml/ref/alter_database.sgml | 4 ++--
doc/src/sgml/ref/alter_domain.sgml | 6 +++---
doc/src/sgml/ref/alter_foreign_table.sgml | 6 +++---
doc/src/sgml/ref/alter_function.sgml | 6 +++---
doc/src/sgml/ref/alter_large_object.sgml | 5 +++--
doc/src/sgml/ref/alter_materialized_view.sgml | 7 ++++---
doc/src/sgml/ref/alter_opclass.sgml | 7 ++++---
doc/src/sgml/ref/alter_operator.sgml | 7 ++++---
doc/src/sgml/ref/alter_procedure.sgml | 7 ++++---
doc/src/sgml/ref/alter_publication.sgml | 10 ++++++----
doc/src/sgml/ref/alter_schema.sgml | 4 ++--
doc/src/sgml/ref/alter_sequence.sgml | 7 ++++---
doc/src/sgml/ref/alter_server.sgml | 4 ++--
doc/src/sgml/ref/alter_statistics.sgml | 7 ++++---
doc/src/sgml/ref/alter_subscription.sgml | 4 ++--
doc/src/sgml/ref/alter_table.sgml | 7 ++++---
doc/src/sgml/ref/alter_tablespace.sgml | 4 ++--
doc/src/sgml/ref/alter_type.sgml | 7 ++++---
doc/src/sgml/ref/alter_view.sgml | 7 ++++---
doc/src/sgml/ref/create_database.sgml | 4 ++--
doc/src/sgml/ref/create_schema.sgml | 4 ++--
doc/src/sgml/ref/grant.sgml | 14 ++++++++++++++
26 files changed, 96 insertions(+), 67 deletions(-)