List:Commits« Previous MessageNext Message »
From:paul Date:December 12 2005 11:51pm
Subject:svn commit - mysqldoc@docsrva: r547 - in trunk: . refman-5.1 refman-common
View as plain text  
Author: paul
Date: 2005-12-13 00:51:55 +0100 (Tue, 13 Dec 2005)
New Revision: 547

Log:
 r4730@frost:  paul | 2005-12-12 17:50:42 -0600
 Some plugin/UDF remarks.


Modified:
   trunk/
   trunk/refman-5.1/extending-mysql.xml
   trunk/refman-5.1/installing.xml
   trunk/refman-5.1/introduction.xml
   trunk/refman-common/news-5.1.xml


Property changes on: trunk
___________________________________________________________________
Name: svk:merge
   - b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:4727
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:1609
   + b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:4730
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:1609

Modified: trunk/refman-5.1/extending-mysql.xml
===================================================================
--- trunk/refman-5.1/extending-mysql.xml	2005-12-12 23:51:41 UTC (rev 546)
+++ trunk/refman-5.1/extending-mysql.xml	2005-12-12 23:51:55 UTC (rev 547)
@@ -489,22 +489,28 @@
     </indexterm>
 
     <remark role="todo">
-      Also to mention: Note the API in the 5.1 upgrading section. Point
-      out that if you're upgrading, you must upgrade the grant tables by
-      running mysql_fix_privilege_tables to make sure the mysql.plugin
-      table exists. Describe the interface functions. Add change note
-      for I.P./U.P. in 5.1.3 changelog.
+      Also to mention: Describe the interface functions.
     </remark>
 
     <remark role="help-category" condition="Plugins"/>
 
     <para>
-      MySQL 5.1 provides a plugin interface that can be used to add new
-      functions to the server. This interface is the successor to the
-      older user-defined function (UDF) interface. It is intended that
-      the UDF interface will be phased out.
+      MySQL 5.1 and up provides a plugin interface that can be used to
+      add new functions to the server. This interface is the successor
+      to the older user-defined function (UDF) interface. (Eventually,
+      the older interface will be phased out and replaced by a plugin
+      interface for UDFs.)
     </para>
 
+    <para>
+      The plugin interface requires the <literal>plugin</literal> table
+      in the <literal>mysql</literal> database. This table is created as
+      part of the MySQL installation process. If you are upgrading from
+      an older version to MySQL 5.1, you should run the
+      <command>mysql_fix_privilege_tables</command> command to create
+      this table. See <xref linkend="upgrading-grant-tables"/>.
+    </para>
+
     <section id="install-plugin">
 
       <title id="title-install-plugin">&title-install-plugin;</title>
@@ -934,8 +940,12 @@
       <para>
         <replaceable>shared_library_name</replaceable> is the basename
         of the shared object file that contains the code that implements
-        the function. The file must be located in a directory that is
-        searched by your system's dynamic linker.
+        the function. The file must be located in the plugin directory.
+        This directory is given by the value of the
+        <literal>plugin_dir</literal> system variable.
+        (<emphasis role="bold">Note:</emphasis> This a change in MySQL
+        5.1. For earlier versions of MySQL, the file can be located in
+        any directory that is searched by your system's dynamic linker.)
       </para>
 
       <para>

Modified: trunk/refman-5.1/installing.xml
===================================================================
--- trunk/refman-5.1/installing.xml	2005-12-12 23:51:41 UTC (rev 546)
+++ trunk/refman-5.1/installing.xml	2005-12-12 23:51:55 UTC (rev 547)
@@ -12171,6 +12171,31 @@
 
         <listitem>
           <para>
+            <emphasis role="bold">Incompatible change</emphasis>: MySQL
+            &current_series; implements support for a plugin API that
+            allows the loading and unloading of components at runtime,
+            without restarting the server. <xref id="plugins"/>. The
+            plugin API requires the <literal>mysql.plugin</literal>
+            table. When upgrading from an older version of MySQL, you
+            should run the <command>mysql_fix_privilege_tables</command>
+            command to create this table. See
+            <xref linkend="upgrading-grant-tables"/>.
+          </para>
+
+          <para>
+            Plugins are installed in the directory named by the
+            <literal>plugin_dir</literal> system variable. This variable
+            also controls the location from which the server loads
+            user-defined functions (UDFs), which is a change from
+            earlier versions of MySQL. That is, all UDF library files
+            now must be installed in the plugin directory. When
+            upgrading from an older version of MySQL, you must migrate
+            your UDF files to the plugin directory.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
             The <literal>table_cache</literal> system variable was
             renamed to <literal>table_open_cache</literal>. Any scripts
             that refer to <literal>table_cache</literal> should be

Modified: trunk/refman-5.1/introduction.xml
===================================================================
--- trunk/refman-5.1/introduction.xml	2005-12-12 23:51:41 UTC (rev 546)
+++ trunk/refman-5.1/introduction.xml	2005-12-12 23:51:55 UTC (rev 547)
@@ -416,7 +416,7 @@
             <emphasis role="bold">Plugin API</emphasis>: MySQL 5.1 will
             add support for a very flexible plugin API that will allow
             the loading and unloading of various components at runtime,
-            without restarting the server. While the work on this are
+            without restarting the server. While the work on this is
             not finished yet, <emphasis>pluggable full-text
             parsers</emphasis> are a first step in this direction. This
             allows users to implement their own input filter on the

Modified: trunk/refman-common/news-5.1.xml
===================================================================
--- trunk/refman-common/news-5.1.xml	2005-12-12 23:51:41 UTC (rev 546)
+++ trunk/refman-common/news-5.1.xml	2005-12-12 23:51:55 UTC (rev 547)
@@ -20,10 +20,18 @@
     The following changelog shows what has been done in the 5.1 tree:
   </para>
 
-  <remark>
-    ADD AN ITEMIZED LIST WHEN WE HAVE SOME ITEMS THAT GO HERE
-  </remark>
+  <itemizedlist>
 
+    <listitem>
+      <para>
+        MySQL 5.1 implements support for a plugin API that allows the
+        loading and unloading of components at runtime, without
+        restarting the server. <xref id="plugins"/>.
+      </para>
+    </listitem>
+
+  </itemizedlist>
+
   <para>
     For a full list of changes, please refer to the changelog sections
     for each individual 5.1.x release.
@@ -258,7 +266,7 @@
           <emphasis role="bold">Plugin API</emphasis>: MySQL 5.1 will
           add support for a very flexible plugin API that will allow the
           loading and unloading of various components at runtime,
-          without restarting the server. While the work on this are not
+          without restarting the server. While the work on this is not
           finished yet, <emphasis>pluggable full-text parsers</emphasis>
           are a first step in this direction. This allows users to
           implement their own input filter on the indexed text, enabling
@@ -268,6 +276,26 @@
           hands it over to the builtin MySQL full-text search. (Author:
           Sergey Vojtovich)
         </para>
+
+        <para>
+          The plugin API requires the <literal>mysql.plugin</literal>
+          table. When upgrading from an older version of MySQL, you
+          should run the <command>mysql_fix_privilege_tables</command>
+          command to create this table. See
+          <xref linkend="upgrading-grant-tables"/>.
+        </para>
+
+        <para>
+          <emphasis role="bold">Incompatible change</emphasis>: Plugins
+          are installed in the directory named by the
+          <literal>plugin_dir</literal> system variable. This variable
+          also controls the location from which the server loads
+          user-defined functions (UDFs), which is a change from earlier
+          versions of MySQL. That is, all UDF library files now must be
+          installed in the plugin directory. When upgrading from an
+          older version of MySQL, you must migrate your UDF files to the
+          plugin directory.
+        </para>
       </listitem>
 
       <listitem>

Thread
svn commit - mysqldoc@docsrva: r547 - in trunk: . refman-5.1 refman-commonpaul13 Dec