Re: pg_upgrade doc uses inconsistent versions within the doc. - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: pg_upgrade doc uses inconsistent versions within the doc.
Date
Msg-id ZRMWQCnV1lCAV7ES@momjian.us
Whole thread Raw
In response to pg_upgrade doc uses inconsistent versions within the doc.  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: pg_upgrade doc uses inconsistent versions within the doc.
List pgsql-docs
On Mon, Sep 18, 2023 at 08:14:04PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/16/pgupgrade.html
> Description:
> 
> I feel like for readability the pg_upgrade doc should use the same
> old_version and new_version examples when showing examples throughout the
> doc page.  
> 
> as an exmaple I'm looking at :
> https://www.postgresql.org/docs/current/pgupgrade.html 
> 
> in some places the example commands use v9.6 and v16. (see step 8)
> 
> but in other places it mixes versions v9.5 and v9.6 (see step 11 sub step 8)

Good point.  I came up with the attached patch.  It uses 9.6 and current
--- the only problem is that the target directory is now:

    /vol1/pg_tblsp/PG_&majorversion;_202307071
                                     ---------

and since the catalog version is not accessible from SGML, it will
usually not match the major version's catalog number.

I would apply this only to Postgres 17 since it isn't really a fix.

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

  Only you can decide what is important to you.

Attachment

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: JSON type unsupported
Next
From: "David G. Johnston"
Date:
Subject: Re: pg_upgrade doc uses inconsistent versions within the doc.