bk commit - mysqldoc@docsrva tree (paul:1.3329)

[paul]

Below is the list of changes that have just been committed into a local
mysqldoc repository of paul. When paul does a push these changes will
be propagated to the main repository and, within 24 hours after the
push, to the public repository.
For information on how to access the public repository
see http://www.mysql.com/doc/I/n/Installing_source_tree.html

ChangeSet
  1.3329 05/08/18 20:42:26 paul@stripped +4 -0
  Clarify that FOUND_ROWS() is transient.

  refman/functions.xml
    1.31 05/08/18 20:42:24 paul@stripped +14 -1
    Clarify that FOUND_ROWS() is transient.

  refman-5.1/functions.xml
    1.12 05/08/18 20:42:23 paul@stripped +14 -1
    Sync.

  refman-5.0/functions.xml
    1.25 05/08/18 20:42:23 paul@stripped +14 -1
    Sync.

  refman-4.1/functions.xml
    1.47 05/08/18 20:42:23 paul@stripped +14 -1
    Sync.

# This is a BitKeeper patch.  What follows are the unified diffs for the
# set of deltas contained in the patch.  The rest of the patch, the part
# that BitKeeper cares about, is below these diffs.
# User:	paul
# Host:	frost.snake.net
# Root:	/Volumes/frost2/MySQL/bk/mysqldoc

--- 1.11/refman-5.1/functions.xml	2005-08-18 19:55:08 -05:00
+++ 1.12/refman-5.1/functions.xml	2005-08-18 20:42:23 -05:00
@@ -11658,7 +11658,20 @@
           </para>
 
           <para>
-            Note that if you are using <literal>SELECT
+            The row count available through
+            <literal>FOUND_ROWS()</literal> is transient and not
+            intended to be available past the statement following the
+            <literal>SELECT SQL_CALC_FOUND_ROWS</literal> statment. If
+            you need to refer to the value later, save it:
+          </para>
+
+<programlisting>
+mysql&gt; <userinput>SELECT SQL_CALC_FOUND_ROWS * FROM ... ;</userinput>
+mysql&gt; <userinput>SET @rows = FOUND_ROWS();</userinput>
+</programlisting>
+
+          <para>
+            If you are using <literal>SELECT
             SQL_CALC_FOUND_ROWS</literal>, MySQL must calculate how many
             rows are in the full result set. However, this is faster
             than running the query again without

--- 1.46/refman-4.1/functions.xml	2005-08-18 19:55:08 -05:00
+++ 1.47/refman-4.1/functions.xml	2005-08-18 20:42:23 -05:00
@@ -10388,7 +10388,20 @@
           </para>
 
           <para>
-            Note that if you are using <literal>SELECT
+            The row count available through
+            <literal>FOUND_ROWS()</literal> is transient and not
+            intended to be available past the statement following the
+            <literal>SELECT SQL_CALC_FOUND_ROWS</literal> statment. If
+            you need to refer to the value later, save it:
+          </para>
+
+<programlisting>
+mysql&gt; <userinput>SELECT SQL_CALC_FOUND_ROWS * FROM ... ;</userinput>
+mysql&gt; <userinput>SET @rows = FOUND_ROWS();</userinput>
+</programlisting>
+
+          <para>
+            If you are using <literal>SELECT
             SQL_CALC_FOUND_ROWS</literal>, MySQL must calculate how many
             rows are in the full result set. However, this is faster
             than running the query again without

--- 1.30/refman/functions.xml	2005-08-18 19:55:09 -05:00
+++ 1.31/refman/functions.xml	2005-08-18 20:42:24 -05:00
@@ -10732,7 +10732,20 @@
           </para>
 
           <para>
-            Note that if you are using <literal>SELECT
+            The row count available through
+            <literal>FOUND_ROWS()</literal> is transient and not
+            intended to be available past the statement following the
+            <literal>SELECT SQL_CALC_FOUND_ROWS</literal> statment. If
+            you need to refer to the value later, save it:
+          </para>
+
+<programlisting>
+mysql&gt; <userinput>SELECT SQL_CALC_FOUND_ROWS * FROM ... ;</userinput>
+mysql&gt; <userinput>SET @rows = FOUND_ROWS();</userinput>
+</programlisting>
+
+          <para>
+            If you are using <literal>SELECT
             SQL_CALC_FOUND_ROWS</literal>, MySQL must calculate how many
             rows are in the full result set. However, this is faster
             than running the query again without

--- 1.24/refman-5.0/functions.xml	2005-08-18 19:55:08 -05:00
+++ 1.25/refman-5.0/functions.xml	2005-08-18 20:42:23 -05:00
@@ -10401,7 +10401,20 @@
           </para>
 
           <para>
-            Note that if you are using <literal>SELECT
+            The row count available through
+            <literal>FOUND_ROWS()</literal> is transient and not
+            intended to be available past the statement following the
+            <literal>SELECT SQL_CALC_FOUND_ROWS</literal> statment. If
+            you need to refer to the value later, save it:
+          </para>
+
+<programlisting>
+mysql&gt; <userinput>SELECT SQL_CALC_FOUND_ROWS * FROM ... ;</userinput>
+mysql&gt; <userinput>SET @rows = FOUND_ROWS();</userinput>
+</programlisting>
+
+          <para>
+            If you are using <literal>SELECT
             SQL_CALC_FOUND_ROWS</literal>, MySQL must calculate how many
             rows are in the full result set. However, this is faster
             than running the query again without