diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml
index 14b12e37dc..7c922821e9 100644
--- a/doc/src/sgml/postgres-fdw.sgml
+++ b/doc/src/sgml/postgres-fdw.sgml
@@ -437,6 +437,41 @@
+
+ Remote Query Execution Environment
+
+
+ In the remote sessions opened by postgres_fdw>,
+ the parameter is set to
+ just pg_catalog>, so that only built-in objects are visible
+ without schema qualification. This is not an issue for queries
+ generated by postgres_fdw> itself, because it always
+ supplies such qualification. However, this can pose a hazard for
+ functions that are executed on the remote server via triggers or rules
+ on remote tables. For example, if a remote table is actually a view,
+ any functions used in that view will be executed with the restricted
+ search path. It is recommended to schema-qualify all names in such
+ functions, or else attach SET search_path> options
+ (see ) to such functions
+ to establish their expected search path environment.
+
+
+
+ postgres_fdw> likewise establishes remote session settings
+ for the parameters ,
+ , ,
+ and . These are less likely
+ to be problematic than search_path>, but can be handled
+ with function SET> options if the need arises.
+
+
+
+ It is not> recommended that you override this behavior by
+ changing the session-level settings of these parameters; that is likely
+ to cause postgres_fdw> to malfunction.
+
+
+
Cross-Version Compatibility