Re: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader

2018-01-31 Thread Bruce Momjian
On Mon, Jan 29, 2018 at 09:31:46PM -0500, Jim Ryan wrote: > This looks great.  Thanks for working on it. Done. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + As you are, so once was I. As I am, so you will

Re: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader

2018-01-29 Thread Jim Ryan
This looks great. Thanks for working on it. Jim On Sat, Jan 27, 2018 at 10:05 AM, Bruce Momjian wrote: > On Fri, Jan 26, 2018 at 11:35:09AM -0700, David G. Johnston wrote: > > On Friday, January 26, 2018, Jim Ryan wrote: > > > > Hey Bruce, > >

Re: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader

2018-01-29 Thread David G. Johnston
On Sat, Jan 27, 2018 at 8:05 AM, Bruce Momjian wrote: > I decided I needed to be more explicit about the major version numbers > so I have added major and minor examples for the 9.6.x series and 10.x > series releases. Patch attached. > > ​Thanks!​ ​+1 ​David J.

Re: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader

2018-01-27 Thread Bruce Momjian
On Fri, Jan 26, 2018 at 11:35:09AM -0700, David G. Johnston wrote: > On Friday, January 26, 2018, Jim Ryan wrote: > > Hey Bruce, > > Thanks for working on this, but wouldn't pg_upgrade be needed from 10.1 to > 10.2?  Aren't those considered major versions,

Re: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader

2018-01-26 Thread Jim Ryan
Ah! Thank you. That makes more sense. I think this could still be confusing for users who did not know about this change and are on 9.x, because the docs now seemingly imply that they would not need to use pg_upgrade when moving from 9.x to 9.y, when they actually do. Is explaining the recent

Re: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader

2018-01-26 Thread Jim Ryan
Hey Bruce, Thanks for working on this, but wouldn't pg_upgrade be needed from 10.1 to 10.2? Aren't those considered major versions, or am I misunderstanding? The source of my (and potentially others) confusion is if from 9.1 to 9.2 is considered a major version change or not. I think most

Re: pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader

2018-01-25 Thread Bruce Momjian
On Mon, Dec 18, 2017 at 09:30:41PM +, 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 PostgreSQLs versioning (where 9.5

pg_upgrade docs are confusing if PostgreSQL's versioning system/language isn't known to reader

2017-12-18 Thread PG Doc comments form
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 PostgreSQLs versioning (where 9.5 and 9.6 are considered major versions) reads the documentation, it is unclear if