Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
Date
Msg-id acLT6tXlMxgQRsT6@momjian.us
Whole thread Raw
In response to Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version  (Laurenz Albe <laurenz.albe@cybertec.at>)
Responses Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
List pgsql-docs
On Tue, Mar 24, 2026 at 05:53:27PM +0100, Laurenz Albe wrote:
> On Tue, 2026-03-24 at 11:04 -0400, Bruce Momjian wrote:
> > On Tue, Mar 24, 2026 at 05:36:42AM -0700, Nikolay Samokhvalov wrote:
> > > On Mon, Mar 23, 2026 at 23:59 Laurenz Albe <laurenz.albe@cybertec.at> wrote:
> > > How about adding a simple remark, like
> > I was under the same impression --- that it only worked with upgrades
> > _from_ PG 18 and later.  However, I can't find any documentation on this
> > limitation, so why did so many think this was true?  I don't think
> > adding anything to the docs is the right approach.
> 
> Bruce, you are confusing me.  Your first sentence suggests that you
> (erroneously) thought that upgrading statistics only works when upgrading

Right.

> *from* v18 or better.  But your last sentence suggests that you'd rather
> not add anything to the documentation that could dispel that misconception.

So, we don't normally document cases where a limitation does not exist. 
I think the logical place to document this is in the PG 18 release
notes.  I am still confused why people, like myself, got this wrong. 
What is the source of the confusion?  Just unclear release notes?

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Do not let urgent matters crowd out time for investment in the future.



pgsql-docs by date:

Previous
From: Laurenz Albe
Date:
Subject: Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
Next
From: Laurenz Albe
Date:
Subject: Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version