Date: Thu, 6 Oct 2022 10:28:27 -0400
From: Bruce Momjian <bruce@momjian.us>
To: jcarson@fastmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: request clarification on pg_restore documentation
Message-ID: <Yz7mC08uk9Y7N1jA@momjian.us>
References: <166446181317.661.16517798061228916974@wrigleys.postgresql.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <166446181317.661.16517798061228916974@wrigleys.postgresql.org>
Archived-At: 
 <https://www.postgresql.org/message-id/Yz7mC08uk9Y7N1jA%40momjian.us>
Precedence: bulk


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