From: paul
Date: December 14 2005 7:36pm
Subject: svn commit - mysqldoc@docsrva: r564 - in trunk: . refman-4.1 refman-5.0 refman-5.1
List-Archive: http://lists.mysql.com/commits/165
Message-Id: <200512141936.jBEJaneH022472@docsrva.mysql.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Author: paul
Date: 2005-12-14 20:36:49 +0100 (Wed, 14 Dec 2005)
New Revision: 564

Log:
 r1671@kite-hub:  paul | 2005-12-14 13:36:18 -0600
 UDF/plugins: Point out that when you write these, you're bound the
 general constraints on writing server code.


Modified:
   trunk/
   trunk/refman-4.1/extending-mysql.xml
   trunk/refman-5.0/extending-mysql.xml
   trunk/refman-5.1/extending-mysql.xml


Property changes on: trunk
___________________________________________________________________
Name: svk:merge
   - b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:4780
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:1648
   + b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:4768
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:1671

Modified: trunk/refman-4.1/extending-mysql.xml
===================================================================
--- trunk/refman-4.1/extending-mysql.xml	2005-12-14 18:33:47 UTC (rev 563)
+++ trunk/refman-4.1/extending-mysql.xml	2005-12-14 19:36:49 UTC (rev 564)
@@ -801,6 +801,19 @@
       </para>
 
       <para>
+        A UDF contains code that becomes part of the running server, so
+        when you write a UDF, you are bound by any and all constraints
+        that otherwise apply to writing server code. For example, you
+        may have problems if you attempt to use functions from the
+        <literal>libstdc++</literal> library. Note that these
+        constraints may change in future versions of the server, so it
+        is possible that server upgrades will require revisions to UDFs
+        that were originally written for older servers. For information
+        about these constraints, see <xref linkend="configure-options"/>
+        and <xref linkend="compilation-problems"/>.
+      </para>
+
+      <para>
         To be able to use UDFs, you need to link
         <command>mysqld</command> dynamically. Don't configure MySQL
         using <option>--with-mysqld-ldflags=-all-static</option>. If you

Modified: trunk/refman-5.0/extending-mysql.xml
===================================================================
--- trunk/refman-5.0/extending-mysql.xml	2005-12-14 18:33:47 UTC (rev 563)
+++ trunk/refman-5.0/extending-mysql.xml	2005-12-14 19:36:49 UTC (rev 564)
@@ -802,6 +802,19 @@
       </para>
 
       <para>
+        A UDF contains code that becomes part of the running server, so
+        when you write a UDF, you are bound by any and all constraints
+        that otherwise apply to writing server code. For example, you
+        may have problems if you attempt to use functions from the
+        <literal>libstdc++</literal> library. Note that these
+        constraints may change in future versions of the server, so it
+        is possible that server upgrades will require revisions to UDFs
+        that were originally written for older servers. For information
+        about these constraints, see <xref linkend="configure-options"/>
+        and <xref linkend="compilation-problems"/>.
+      </para>
+
+      <para>
         To be able to use UDFs, you need to link
         <command>mysqld</command> dynamically. Don't configure MySQL
         using <option>--with-mysqld-ldflags=-all-static</option>. If you

Modified: trunk/refman-5.1/extending-mysql.xml
===================================================================
--- trunk/refman-5.1/extending-mysql.xml	2005-12-14 18:33:47 UTC (rev 563)
+++ trunk/refman-5.1/extending-mysql.xml	2005-12-14 19:36:49 UTC (rev 564)
@@ -511,6 +511,19 @@
       this table. See <xref linkend="upgrading-grant-tables"/>.
     </para>
 
+    <para>
+      A plugin contains code that becomes part of the running server, so
+      when you write a plugin, you are bound by any and all constraints
+      that otherwise apply to writing server code. For example, you may
+      have problems if you attempt to use functions from the
+      <literal>libstdc++</literal> library. Note that these constraints
+      may change in future versions of the server, so it is possible
+      that server upgrades will require revisions to plugins that were
+      originally written for older servers. For information about these
+      constraints, see <xref linkend="configure-options"/> and
+      <xref linkend="compilation-problems"/>.
+    </para>
+
     <section id="install-plugin">
 
       <title id="title-install-plugin">&title-install-plugin;</title>
@@ -1027,6 +1040,19 @@
       </para>
 
       <para>
+        A UDF contains code that becomes part of the running server, so
+        when you write a UDF, you are bound by any and all constraints
+        that otherwise apply to writing server code. For example, you
+        may have problems if you attempt to use functions from the
+        <literal>libstdc++</literal> library. Note that these
+        constraints may change in future versions of the server, so it
+        is possible that server upgrades will require revisions to UDFs
+        that were originally written for older servers. For information
+        about these constraints, see <xref linkend="configure-options"/>
+        and <xref linkend="compilation-problems"/>.
+      </para>
+
+      <para>
         To be able to use UDFs, you need to link
         <command>mysqld</command> dynamically. Don't configure MySQL
         using <option>--with-mysqld-ldflags=-all-static</option>. If you