Add POLICY to COMMENT documentation

COMMENT supports POLICY but the documentation hadn't caught up with
that fact.

Patch by Charles Clavadetscher

Back-patch to 9.5 where POLICY was added.

diff --git a/doc/src/sgml/ref/comment.sgml b/doc/src/sgml/ref/comment.sgml
index 10307385423762896e13a7fbed480ed7153e6f6c..3321d4b49d67929450032f468ee4be9d5ed5874f 100644 (file)
--- a/doc/src/sgml/ref/comment.sgml
+++ b/doc/src/sgml/ref/comment.sgml
@@ -43,6 +43,7 @@ COMMENT ON
   OPERATOR operator_name (left_type, right_type) |
   OPERATOR CLASS object_name USING index_method |
   OPERATOR FAMILY object_name USING index_method |
+  POLICY policy_name ON table_name |
   [ PROCEDURAL ] LANGUAGE object_name |
   ROLE object_name |
   RULE rule_name ON table_name |
@@ -113,6 +114,7 @@ COMMENT ON
     constraint_name
     function_name
     operator_name
+    policy_name
     rule_name
     trigger_name
     
@@ -133,9 +135,9 @@ COMMENT ON
     domain_name
     
      
-      When creating a comment on a constraint on a table or a domain, these
-      parameters specify the name of the table or domain on which the
-      constraint is defined.
+      When creating a comment on a constraint, a table, a domain or
+      a policy these parameters specify the name of the table or domain on
+      which the constraint is defined.
      
     
    
@@ -315,6 +317,7 @@ COMMENT ON OPERATOR ^ (text, text) IS 'Performs intersection of two texts';
 COMMENT ON OPERATOR - (NONE, integer) IS 'Unary minus';
 COMMENT ON OPERATOR CLASS int4ops USING btree IS '4 byte integer operators for btrees';
 COMMENT ON OPERATOR FAMILY integer_ops USING btree IS 'all integer operators for btrees';
+COMMENT ON POLICY my_policy ON mytable IS 'Filter rows by users';
 COMMENT ON ROLE my_role IS 'Administration group for finance tables';
 COMMENT ON RULE my_rule ON my_table IS 'Logs updates of employee records';
 COMMENT ON SCHEMA my_schema IS 'Departmental data';