Improve privilege documentation for maintenance commands.
The documentation of the required privileges for maintenance
commands (i.e., VACUUM, ANALYZE, CLUSTER, LOCK TABLE, REFRESH
MATERIALIZED VIEW, and REINDEX) is redundant, inaccurate, and
difficult to read. This commit fixes and simplifies this
documentation by removing references to ownership, superuser, and
the pg_maintain role. In addition, this removes notes about
database-wide VACUUM and ANALYZE, clarifies matters for REINDEX on
partitioned indexes and tables, and strengthens the description of
the pg_maintain role.
Reviewed-by: Michael Paquier, Jeff Davis
Discussion: https://postgr.es/m/20230615041044.GA736001%40nathanxps13
Branch
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/c2122aae636d7121d5cdb64ad1444e1df7f69257
Modified Files
--------------
doc/src/sgml/ref/analyze.sgml | 8 +-------
doc/src/sgml/ref/cluster.sgml | 6 +-----
doc/src/sgml/ref/lock.sgml | 6 ++----
doc/src/sgml/ref/refresh_materialized_view.sgml | 6 ++----
doc/src/sgml/ref/reindex.sgml | 26 ++++++++++++-------------
doc/src/sgml/ref/vacuum.sgml | 8 +-------
doc/src/sgml/user-manag.sgml | 3 ++-
7 files changed, 22 insertions(+), 41 deletions(-)