Improve documentation about foreign data wrapper validator functions.

Modified version of a patch by Shigeru Hanada.

diff --git a/doc/src/sgml/fdwhandler.sgml b/doc/src/sgml/fdwhandler.sgml
index c8ae861852a8d2a98889db8718a38e04149e4dcb..0637de7d1f625b6f74a71884f15b8894c3a01eaf 100644 (file)
--- a/doc/src/sgml/fdwhandler.sgml
+++ b/doc/src/sgml/fdwhandler.sgml
@@ -38,14 +38,20 @@
    
 
    
-    The validator function is responsible for validating options given in the
-    CREATE FOREIGN DATA WRAPPER, CREATE
-    SERVER and CREATE FOREIGN TABLE commands.
+    The validator function is responsible for validating options given in
+    CREATE and ALTER commands for its
+    foreign data wrapper, as well as foreign servers, user mappings, and
+    foreign tables using the wrapper.
     The validator function must be registered as taking two arguments, a text
     array containing the options to be validated, and an OID representing the
     type of object the options are associated with (in the form of the OID
-    of the system catalog the object would be stored in).  If no validator
-    function is supplied, the options are not checked at object creation time.
+    of the system catalog the object would be stored in, either
+    ForeignDataWrapperRelationId,
+    ForeignServerRelationId,
+    UserMappingRelationId,
+    or ForeignTableRelationId).
+    If no validator function is supplied, options are not checked at object
+    creation time or object alteration time.