diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml
new file mode 100644
index 4d03b12..72e3cb6
*** a/doc/src/sgml/pgupgrade.sgml
--- b/doc/src/sgml/pgupgrade.sgml
*************** psql --username postgres --file script.s
*** 460,466 ****
       cluster's data directories by running the script mentioned when
       <command>pg_upgrade</command> completes. You can also delete the
       old installation directories
!      (e.g. <filename>bin</>, <filename>share</>).
      </para>
     </step>
  
--- 460,467 ----
       cluster's data directories by running the script mentioned when
       <command>pg_upgrade</command> completes. You can also delete the
       old installation directories
!      (e.g. <filename>bin</>, <filename>share</>).  This will not work
!      if you have tablespaces inside the old data directory.
      </para>
     </step>