Reword CREATE POLICY parameter descriptions

The parameter description for the using_expression and check_expression
in CREATE POLICY were unclear and arguably included a typo.  Clarify
and improve the consistency of that language.

Pointed out by Dean Rasheed.

diff --git a/doc/src/sgml/ref/create_policy.sgml b/doc/src/sgml/ref/create_policy.sgml
index cf464cb51f19d71e1fdb54b9b6e2638943768dc7..646b08d51b55957f6b860ca89de5f32005cd0206 100644 (file)
--- a/doc/src/sgml/ref/create_policy.sgml
+++ b/doc/src/sgml/ref/create_policy.sgml
@@ -158,7 +158,8 @@ CREATE POLICY name ON 
       Any SQL conditional expression (returning
       boolean).  The conditional expression cannot contain
       any aggregate or window functions.  This expression will be added
-      to queries to filter out the records which are visible to the query.
+      to queries that refer to the table if row level security is enabled,
+      and will allow access to rows matching the expression.
      
     
    
@@ -168,11 +169,12 @@ CREATE POLICY name ON 
     
      
       Any SQL conditional expression (returning
-      boolean).  The condition expression cannot contain
-      any aggregate or window functions.  This expression will be added
-      to queries which are attempting to add records to the table as
-      with-check options, and an error will be thrown if this condition
-      returns false for any records being added.
+      boolean).  The conditional expression cannot contain
+      any aggregate or window functions.  This expression will be used with
+      INSERT and UPDATE queries against
+      the table if row level security is enabled and an error will be thrown
+      if the expression evaluates to false for any of the records inserted
+      or any of the records which result from the update.