From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | jim(at)room118solutions(dot)com, pgsql-docs(at)postgresql(dot)org |
Subject: | Re: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader |
Date: | 2018-01-26 00:26:18 |
Message-ID: | 20180126002618.GA20836@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Mon, Dec 18, 2017 at 09:30:41PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.6/static/pgupgrade.html
> Description:
>
> If a reader who is unfamiliar with PostgreSQL's versioning (where 9.5 and
> 9.6 are considered major versions) reads the documentation, it is unclear if
> they need to use pg_upgrade to migrate from 9.5 to 9.6, for example.
>
> The documentation says upgrading "from 9.6.3 to the current major release"
> requires pg_upgrade, but not "from 9.6.2 to 9.6.3".
>
> The problem with that language is that the current release of PostgreSQL is
> 10. So is pg_upgrade required to upgrade from 9.6.3 to current (10) because
> 9 and 10 are major versions or because 9.6 and 10.0 are major versions? (the
> latter).
>
> It would be clearer if the documentation covered all three cases:
> 9.6.3 -> 10.0.0 and 9.5.1 -> 9.6.3: pg_upgrade should be used
> 9.6.2 -> 9.6.3: pg_upgrade not needed
>
> Or if the documentation simply noted that the second decimal is considered a
> major release.
How is this attached patch?
--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +
Attachment | Content-Type | Size |
---|---|---|
version.diff | text/x-diff | 848 bytes |
From | Date | Subject | |
---|---|---|---|
Next Message | Peter Eisentraut | 2018-01-26 03:59:23 | Re: Correction of intermediate certificate handling |
Previous Message | Bruce Momjian | 2018-01-25 22:55:23 | Re: Addition to / Clarification in 9.7.1. LIKE |