Thread: request clarification on pg_restore documentation

request clarification on pg_restore documentation

From
PG Doc comments form
Date:
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.

Re: request clarification on pg_restore documentation

From
Bruce Momjian
Date:
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@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

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