diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index ed88ac0..4c71ea4 100644
*** a/doc/src/sgml/libpq.sgml
--- b/doc/src/sgml/libpq.sgml
*************** char *PQencryptPasswordConn(PGconn *conn
*** 7116,7121 ****
--- 7116,7154 ----
      </listitem>
     </varlistentry>
  
+    <varlistentry id="libpq-PQchangePassword">
+     <term><function>PQchangePassword</function><indexterm><primary>PQchangePassword</primary></indexterm></term>
+ 
+     <listitem>
+      <para>
+       Changes a <productname>PostgreSQL</productname> password.
+ <synopsis>
+ PGresult *PQchangePassword(PGconn *conn, const char *user, const char *passwd);
+ </synopsis>
+       This function uses <function>PQencryptPasswordConn</function>
+       to build and execute the command <literal>ALTER USER ... PASSWORD
+       '...'</literal>, thereby changing the user's password. It exists for
+       the same reason as <function>PQencryptPasswordConn</function>, but
+       is more convenient as it both builds and runs the command for you.
+      </para>
+ 
+      <para>
+       The <parameter>user</parameter> and <parameter>passwd</parameter> arguments
+       are the SQL name of the target user, and the new cleartext password.
+      </para>
+ 
+      <para>
+       Returns a <structname>PGresult</structname> pointer or possibly a null
+       pointer. The <xref linkend="libpq-PQresultStatus"/> function
+       should be called to check the return value for any errors (including
+       the value of a null pointer, in which case it will return
+       <symbol>PGRES_FATAL_ERROR</symbol>). Use
+       <xref linkend="libpq-PQerrorMessage"/> to get more information about such
+       errors.
+      </para>
+     </listitem>
+    </varlistentry>
+ 
     <varlistentry id="libpq-PQencryptPassword">
      <term><function>PQencryptPassword</function><indexterm><primary>PQencryptPassword</primary></indexterm></term>