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
+ ¤t_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-common | paul | 13 Dec |
