diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml
index 79e79aa6ce2..3d696d8c9f4 100644
--- a/doc/src/sgml/postgres-fdw.sgml
+++ b/doc/src/sgml/postgres-fdw.sgml
@@ -389,6 +389,14 @@ OPTIONS (ADD password_required 'false');
        table would have attempted to fetch and import the remote statistics
        first if this option was enabled.
       </para>
+
+      <para>
+       Note that this option doesn't currently handle the case where the
+       remote table is inherited.  Note also that if the remote table was
+       inherited in the past, the option considers it inherited even if it
+       isn't currently inherited.  These restrictions might be fixed in future
+       releases.
+      </para>
      </listitem>
     </varlistentry>