Re: per feedback I received directly, pg_dump manpage patch - Mailing list pgsql-docs

From Alvaro Herrera
Subject Re: per feedback I received directly, pg_dump manpage patch
Date
Msg-id 20150528013101.GG5885@postgresql.org
Whole thread Raw
In response to per feedback I received directly, pg_dump manpage patch  ("Joshua D. Drake" <jd@commandprompt.com>)
Responses Re: per feedback I received directly, pg_dump manpage patch  ("Joshua D. Drake" <jd@commandprompt.com>)
Re: per feedback I received directly, pg_dump manpage patch  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
Joshua D. Drake wrote:
> The man page does not clearly state that pg_dump will not dump things like
> users or roles. It does mention briefly in the notes section that pg_dumpall
> is needed for items that are set via SET but that isn't very clear on the
> other items.

I agree that we need a warning about this, but I think it should be a
bit more generic rather than focused exclusively on pg_dumpall; perhaps
something like "global objs such as roles/tblspcs should be backed up
separately, for example using pg_dumpall".

I didn't check the location of the warning in your patch, or whether a
warning is really appropriate rather than, say, <note> or a plain
<para>.

--
Álvaro Herrera                http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


pgsql-docs by date:

Previous
From: "Joshua D. Drake"
Date:
Subject: per feedback I received directly, pg_dump manpage patch
Next
From: "Joshua D. Drake"
Date:
Subject: Re: per feedback I received directly, pg_dump manpage patch