Re: request clarification on pg_restore documentation - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: request clarification on pg_restore documentation
Date
Msg-id Yz7mC08uk9Y7N1jA@momjian.us
Whole thread Raw
In response to request clarification on pg_restore documentation  (PG Doc comments form <noreply@postgresql.org>)
List pgsql-docs
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




pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Minor documentation fixes
Next
From: PG Doc comments form
Date:
Subject: Comparison Predicates - example - documentation seems contradictory?