Add pg_upgrade docs about binary compatibility, per Robert Haas.
authorBruce Momjian
Tue, 25 May 2010 14:50:56 +0000 (14:50 +0000)
committerBruce Momjian
Tue, 25 May 2010 14:50:56 +0000 (14:50 +0000)
doc/src/sgml/pgupgrade.sgml

index 0b9b5c3cc996b6130b7039bbcfb47bf482cce992..e5c054c1375b5eeb315c6f736a46224680481c4f 100644 (file)
@@ -1,4 +1,4 @@
-
+
 
 
  pg_upgrade
   9.0.1 -> 9.0.4.
  
 
+  pg_upgrade works because, though new features are
+  regularly added to Postgres major releases, the internal data storage
+  format rarely changes.  pg_upgrade does its best to
+  make sure the old and new clusters are binary-compatible, e.g.  by
+  checking for compatible compile-time settings.  It is important that
+  any external modules are also binary compatibile, though this cannot
+  be checked by pg_upgrade.
+
  
   Supported Versions
 
@@ -440,7 +450,6 @@ psql --username postgres --file script.sql postgres
   
   Limitations in migrating <emphasis>from</> PostgreSQL 8.3
  
   
    Upgrading from PostgreSQL 8.3 has additional restrictions not present
    when upgrading from later PostgreSQL releases.  For example,
@@ -502,8 +511,8 @@ psql --username postgres --file script.sql postgres
    For Windows users, note that due to different integer datetimes settings
    used by the one-click installer and the MSI installer, it is only
    possible to upgrade from version 8.3 of the one-click distribution to
-   version 8.4 of the one-click distribution. It is not possible to upgrade
-   from the MSI installer to the one-click installer.
+   version 8.4 or later of the one-click distribution. It is not
+   possible to upgrade from the MSI installer to the one-click installer.