Improve privilege documentation for maintenance commands.
authorNathan Bossart <nathan@postgresql.org>
Thu, 22 Jun 2023 22:48:38 +0000 (15:48 -0700)
committerNathan Bossart <nathan@postgresql.org>
Thu, 22 Jun 2023 22:48:38 +0000 (15:48 -0700)
commitc2122aae636d7121d5cdb64ad1444e1df7f69257
tree48861cd4c521fd1323914b42b51093c72928422e
parent4dbdb82513b65ab3a29e431f0233009c8a0fa890
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
doc/src/sgml/ref/analyze.sgml
doc/src/sgml/ref/cluster.sgml
doc/src/sgml/ref/lock.sgml
doc/src/sgml/ref/refresh_materialized_view.sgml
doc/src/sgml/ref/reindex.sgml
doc/src/sgml/ref/vacuum.sgml
doc/src/sgml/user-manag.sgml