diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index 8314fce78f..c6b5bd0e54 100644
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -3878,6 +3878,15 @@ ALTER TABLE measurement ATTACH PARTITION measurement_y2008m02
+ UPDATE row movement is not supported in the cases
+ where the old row is contained in a foreign table partition. Also,
+ moving the new row into a foreign table partition is supported only
+ if the table's FDW supports tuple routing.
+
+
+
+
+
BEFORE ROW triggers, if necessary, must be defined
on individual partitions, not the partitioned table.