diff --git a/doc/src/sgml/ref/pgupgrade.sgml b/doc/src/sgml/ref/pgupgrade.sgml
new file mode 100644
index 055eac3..62f5cb3
*** a/doc/src/sgml/ref/pgupgrade.sgml
--- b/doc/src/sgml/ref/pgupgrade.sgml
***************
*** 24,32 ****
     <arg choice="plain"><option>-B</option></arg>
     <arg choice="plain"><replaceable>newbindir</replaceable></arg>
     <arg choice="plain"><option>-d</option></arg>
!    <arg choice="plain"><replaceable>olddatadir</replaceable></arg>
     <arg choice="plain"><option>-D</option></arg>
!    <arg choice="plain"><replaceable>newdatadir</replaceable></arg>
     <arg rep="repeat"><replaceable>option</replaceable></arg>
    </cmdsynopsis>
   </refsynopsisdiv>
--- 24,32 ----
     <arg choice="plain"><option>-B</option></arg>
     <arg choice="plain"><replaceable>newbindir</replaceable></arg>
     <arg choice="plain"><option>-d</option></arg>
!    <arg choice="plain"><replaceable>oldconfigdir</replaceable></arg>
     <arg choice="plain"><option>-D</option></arg>
!    <arg choice="plain"><replaceable>newconfigdir</replaceable></arg>
     <arg rep="repeat"><replaceable>option</replaceable></arg>
    </cmdsynopsis>
   </refsynopsisdiv>
***************
*** 99,114 ****
       </varlistentry>
  
       <varlistentry>
!       <term><option>-d</option> <replaceable>datadir</replaceable></term>
!       <term><option>--old-datadir=</option><replaceable>datadir</replaceable></term>
!       <listitem><para>the old cluster data directory; environment
        variable <envar>PGDATAOLD</envar></para></listitem>
       </varlistentry>
  
       <varlistentry>
!       <term><option>-D</option> <replaceable>datadir</replaceable></term>
!       <term><option>--new-datadir=</option><replaceable>datadir</replaceable></term>
!       <listitem><para>the new cluster data directory; environment
        variable <envar>PGDATANEW</envar></para></listitem>
       </varlistentry>
  
--- 99,114 ----
       </varlistentry>
  
       <varlistentry>
!       <term><option>-d</option> <replaceable>configdir</replaceable></term>
!       <term><option>--old-datadir=</option><replaceable>configdir</replaceable></term>
!       <listitem><para>the old database cluster configuration directory; environment
        variable <envar>PGDATAOLD</envar></para></listitem>
       </varlistentry>
  
       <varlistentry>
!       <term><option>-D</option> <replaceable>configdir</replaceable></term>
!       <term><option>--new-datadir=</option><replaceable>configdir</replaceable></term>
!       <listitem><para>the new database cluster configuration directory; environment
        variable <envar>PGDATANEW</envar></para></listitem>
       </varlistentry>
  
*************** pg_upgrade.exe
*** 476,482 ****
        <title>Save configuration files</title>
  
        <para>
!        Save any configuration files from the old standbys' data
         directories you need to keep, e.g.  <filename>postgresql.conf</filename>,
         <literal>recovery.conf</literal>, because these will be overwritten or
         removed in the next step.
--- 476,482 ----
        <title>Save configuration files</title>
  
        <para>
!        Save any configuration files from the old standbys' configuration
         directories you need to keep, e.g.  <filename>postgresql.conf</filename>,
         <literal>recovery.conf</literal>, because these will be overwritten or
         removed in the next step.