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. Thanks for PostgreSQL! Jim