From: Stephen Frost <sfrost@snowman.net>
Date: Thu, 29 Jan 2015 04:21:54 +0000 (-0500)
Subject: Reword CREATE POLICY parameter descriptions
X-Git-Tag: REL9_5_ALPHA1~855
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1c993b3aceb7e0ccf32b59280b266b1f4f7b077e;p=postgresql

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 cf464cb51f..646b08d51b 100644
--- a/doc/src/sgml/ref/create_policy.sgml
+++ b/doc/src/sgml/ref/create_policy.sgml
@@ -158,7 +158,8 @@ CREATE POLICY <replaceable class="parameter">name</replaceable> ON <replaceable
       Any <acronym>SQL</acronym> conditional expression (returning
       <type>boolean</type>).  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.
      </para>
     </listitem>
    </varlistentry>
@@ -168,11 +169,12 @@ CREATE POLICY <replaceable class="parameter">name</replaceable> ON <replaceable
     <listitem>
      <para>
       Any <acronym>SQL</acronym> conditional expression (returning
-      <type>boolean</type>).  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.
+      <type>boolean</type>).  The conditional expression cannot contain
+      any aggregate or window functions.  This expression will be used with
+      <command>INSERT</command> and <command>UPDATE</command> 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.
      </para>
     </listitem>
    </varlistentry>