Clarify STABLE function documentation to highlight how such functions

can be optimized.

diff --git a/doc/src/sgml/xfunc.sgml b/doc/src/sgml/xfunc.sgml
index f9840bd4663c667ccc5483033e2e5b3904dae3ea..46d895b745f99750990019043d53b5387f5b0ba7 100644 (file)
--- a/doc/src/sgml/xfunc.sgml
+++ b/doc/src/sgml/xfunc.sgml
@@ -1,5 +1,5 @@
 
 
  
@@ -899,13 +899,13 @@ CREATE FUNCTION test(int, int) RETURNS int
      
       A STABLE function cannot modify the database and is
       guaranteed to return the same results given the same arguments
-      for all calls within a single surrounding query.  This category
-      allows the optimizer to optimize away multiple calls of the function
-      within a single query.  In particular, it is safe to use an expression
-      containing such a function in an index scan condition.  (Since an
-      index scan will evaluate the comparison value only once, not once at
-      each row, it is not valid to use a VOLATILE function in
-      an index scan condition.)
+      for all rows within a single statement. This category allows the
+      optimizer to optimize multiple calls of the function to a single
+      call. In particular, it is safe to use an expression containing
+      such a function in an index scan condition. (Since an index scan
+      will evaluate the comparison value only once, not once at each
+      row, it is not valid to use a VOLATILE function in an
+      index scan condition.)