diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index a0a7435a03..5fe5f86402 100644
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -3964,14 +3964,6 @@ ALTER TABLE measurement ATTACH PARTITION measurement_y2008m02
-
-
- While primary keys are supported on partitioned tables, foreign
- keys referencing partitioned tables are not supported. (Foreign key
- references from a partitioned table to some other table are supported.)
-
-
-
BEFORE ROW triggers, if necessary, must be defined
@@ -4354,6 +4346,14 @@ ALTER TABLE measurement_y2008m02 INHERIT measurement;
+
+
+ Indexes and foreign key constraints apply to single tables and not
+ to their inheritance children, hence they have some
+ caveats to be aware of.
+
+
+
The schemes shown here assume that the values of a row's key column(s)