diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml
new file mode 100644
index 301222c..998cb2f
*** a/doc/src/sgml/pgupgrade.sgml
--- b/doc/src/sgml/pgupgrade.sgml
*************** psql --username postgres --file script.s
*** 529,535 ****
    <para>
     A Log-Shipping Standby Server (<xref linkend="warm-standby">) cannot
     be upgraded because the server must allow writes.  The simplest way
!    is to upgrade the primary and use rsync to rebuild the standbys.
    </para>
  
    <para>
--- 529,538 ----
    <para>
     A Log-Shipping Standby Server (<xref linkend="warm-standby">) cannot
     be upgraded because the server must allow writes.  The simplest way
!    is to upgrade the primary and use <command>rsync</> to rebuild the
!    standbys.  You can run <command>rsync</> while the primary is down,
!    or as part of a base backup (<xref linkend="backup-base-backup">)
!    which overwrites the old standby cluster.
    </para>
  
    <para>