diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index ec6b4c33113..f13a6cd944d 100644
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -372,6 +372,11 @@ WITH ( MODULUS numeric_literal, REM
tables may not be declared NOT VALID at present.
+
+ The addition of a foreign key constraint requires a
+ SHARE ROW EXCLUSIVE lock on the referenced table.
+
+
Additional restrictions apply when unique or primary key constraints
are added to partitioned tables; see .
diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 5a19f94ce91..10428f8ff03 100644
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -992,7 +992,9 @@ WITH ( MODULUS numeric_literal, REM
is used. The referenced columns must be the columns of a non-deferrable
unique or primary key constraint in the referenced table. The user
must have REFERENCES permission on the referenced table
- (either the whole table, or the specific referenced columns).
+ (either the whole table, or the specific referenced columns). The
+ addition of a foreign key constraint requires a
+ SHARE ROW EXCLUSIVE lock on the referenced table.
Note that foreign key constraints cannot be defined between temporary
tables and permanent tables. Also note that while it is possible to
define a foreign key on a partitioned table, it is not possible to