Re: request clarification on pg_restore documentation

Thread moved to hackers.

---------------------------------------------------------------------------

On Thu, Sep 29, 2022 at 02:30:13PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/14/app-pgrestore.html
> Description:
>
> pg_restore seems to have two ways to restore data:
>
> --section=data
>
> or
>
> --data-only
>
> There is this cryptic warning that --data-only is "similar to but for
> historical reasons different from" --section=data
>
> But there is no further explanation of what those differences are or what
> might be missed or different in your restore if you pick one option or the
> other. Maybe one or the other option is the "preferred current way" and one
> is the "historical way" or they are aimed at different types of use cases,
> but that's not clear.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Indecision is a decision. Inaction is an action. Mark Batterson