pgsql: Improve documentation of the role-dropping process.

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.

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/1ea0c73c2b112911fb2ef297121be92d3b0ca35e

Modified Files
--------------
doc/src/sgml/ref/drop_owned.sgml | 9 ++++-
doc/src/sgml/ref/drop_role.sgml | 8 ++--
doc/src/sgml/ref/drop_user.sgml | 2 +-
doc/src/sgml/ref/reassign_owned.sgml | 23 ++++++-----
doc/src/sgml/user-manag.sgml | 70 +++++++++++++++++++++++++++++++---
5 files changed, 89 insertions(+), 23 deletions(-)

--
Sent via pgsql-committers mailing list (pgsql-committers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-committers