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

From David G. Johnston
Subject Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
Date
Msg-id CAKFQuwYmspFfkno8Xf_RL4C5AQFDgvSXRcg5kmofrRy=cz88jw@mail.gmail.com
Whole thread
In response to Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version  (Nikolay Samokhvalov <nik@postgres.ai>)
List pgsql-docs
On Wednesday, March 25, 2026, Nikolay Samokhvalov <nik@postgres.ai> wrote:

If you don't know anything about implementation, it is natural to
expect that something new will work only when both old and new
clusters support it.


But we don’t call out “new features” in the documentation.  Just “features”.  And so when the pg_upgrade docs says “pg_upgrade supports upgrades from 9.2.X and later” then unless there is a note to the contrary (which there is not here) that applies to everything pg_upgrade does.

Put differently, read the docs as if you were unaware in which version that capability was introduced.  This is the style/assumption the documentation is written in/using.

David J.

pgsql-docs by date:

Previous
From: Nikolay Samokhvalov
Date:
Subject: Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
Next
From: Boris Mironov
Date:
Subject: Request for cleaner explanation of default_toast_compression parameter