Improve documentation of the role-dropping process.
authorTom Lane <tgl@sss.pgh.pa.us>
Wed, 7 Oct 2015 20:12:06 +0000 (16:12 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 7 Oct 2015 20:12:06 +0000 (16:12 -0400)
commit32e53593f95870dc5dc455caa5ca8ad3f36ef271
tree0fddddecb9c615ee96ec13bebb99032592558cf7
parent31bc563b9be306623c5e9a52816b432945fa6df9
Improve documentation of the role-dropping process.

In general one may have to run both REASSIGN OWNED and DROP OWNED to get
rid of all the dependencies of a role to be dropped.  This was alluded to
in the REASSIGN OWNED man page, but not really spelled out in full; and in
any case the procedure ought to be documented in a more prominent place
than that.  Add a section to the "Database Roles" chapter explaining this,
and do a bit of wordsmithing in the relevant commands' man pages.
doc/src/sgml/ref/drop_owned.sgml
doc/src/sgml/ref/drop_role.sgml
doc/src/sgml/ref/drop_user.sgml
doc/src/sgml/ref/reassign_owned.sgml
doc/src/sgml/user-manag.sgml