svn: /phpdoc/en/trunk/reference/mysqlnd/ plugin.xml stats.xml
| From: | Philip Olson | Date: | Mon, 03 Dec 2012 07:29:14 +0000 |
| Subject: | svn: /phpdoc/en/trunk/reference/mysqlnd/ plugin.xml stats.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-10826@lists.php.net to get a copy of this message | ||
philip Mon, 03 Dec 2012 07:29:14 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=328620
Log:
Formalized informal tables, which adds titles
Changed paths:
U phpdoc/en/trunk/reference/mysqlnd/plugin.xml
U phpdoc/en/trunk/reference/mysqlnd/stats.xml
Modified: phpdoc/en/trunk/reference/mysqlnd/plugin.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlnd/plugin.xml 2012-12-03 07:13:33 UTC (rev 328619)
+++ phpdoc/en/trunk/reference/mysqlnd/plugin.xml 2012-12-03 07:29:14 UTC (rev 328620)
@@ -285,7 +285,8 @@
The following table shows PHP versions and the corresponding
<literal>mysqlnd</literal> version contained within.
</para>
- <informaltable>
+ <table>
+ <title>The bundled mysqlnd version per PHP release</title>
<tgroup cols="2">
<thead>
<row>
@@ -316,7 +317,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
Plugin developers can determine the <literal>mysqlnd</literal>
version through accessing <literal>MYSQLND_VERSION</literal>, which
@@ -325,7 +326,8 @@
<literal>MYSQLND_VERSION_ID</literal>, which is an integer such as
50007. Developers can calculate the version number as follows:
</para>
- <informaltable>
+ <table>
+ <title>MYSQLND_VERSION_ID calculation table</title>
<tgroup cols="2">
<thead>
<row>
@@ -352,7 +354,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
During development, developers should refer to the
<literal>mysqlnd</literal> version number for compatibility and
@@ -375,7 +377,8 @@
know a little of how <literal>mysqlnd</literal> itself is organized.
<literal>Mysqlnd</literal> consists of the following modules:
</para>
- <informaltable>
+ <table>
+ <title>The mysqlnd organization chart, per module</title>
<tgroup cols="2">
<tbody>
<row>
@@ -408,7 +411,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
<emphasis role="bold">C Object Oriented Paradigm</emphasis>
</para>
@@ -561,7 +564,8 @@
The following table shows how to calculate the position of the
pointer for a specific plugin:
</para>
- <informaltable>
+ <table>
+ <title>Pointer calculations for mysqlnd</title>
<tgroup cols="2">
<tbody>
<row>
@@ -582,7 +586,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
If you plan to subclass any of the <literal>mysqlnd</literal> object
constructors, which is allowed, you must keep this in mind!
@@ -629,10 +633,8 @@
allocator has some useful features, such as the ability to use a
debug allocator in a non-debug build.
</para>
- <para>
- <emphasis role="Bold"> When and how to subclass </emphasis>
- </para>
- <informaltable>
+ <table>
+ <title>When and how to subclass</title>
<tgroup cols="4">
<tbody>
<row>
@@ -681,7 +683,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
You must not manipulate function tables at any time later than MINIT
if it is not allowed according to the above table.
@@ -704,10 +706,8 @@
The advantage of the shared function table approach is performance.
There is no need to copy a function table for each and every object.
</para>
- <para>
- Constructors
- </para>
- <informaltable>
+ <table>
+ <title>Constructor status</title>
<tgroup cols="4">
<tbody>
<row>
@@ -799,7 +799,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
It is strongly recommended that you do not entirely replace a
constructor. The constructors perform memory allocations. The memory
@@ -815,10 +815,8 @@
function tables of objects with non-shared object tables, such as
Resultset, Network, Wire Protocol.
</para>
- <para>
- <emphasis role="bold">Destruction</emphasis>
- </para>
- <informaltable>
+ <table>
+ <title>Destruction status</title>
<tgroup cols="3">
<tbody>
<row>
@@ -858,7 +856,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
The destructors are the appropriate place to free properties,
<literal>mysqlnd_plugin_get_plugin_<replaceable><object></replaceable>_data()</literal>.
@@ -1016,11 +1014,8 @@
always call the parent method. The plugins should always cooperate
with <literal>mysqlnd</literal> itself.
</para>
- <para>
- <emphasis role="bold">Issues: an example of chaining and
- cooperation</emphasis>
- </para>
- <informaltable>
+ <table>
+ <title>Issues: an example of chaining and cooperation</title>
<tgroup cols="3">
<tbody>
<row>
@@ -1072,7 +1067,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
In this scenario, a cache (<literal>ext/mysqlnd_cache</literal>) and
a monitor (<literal>ext/mysqlnd_monitor</literal>) plugin are loaded.
Modified: phpdoc/en/trunk/reference/mysqlnd/stats.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlnd/stats.xml 2012-12-03 07:13:33 UTC (rev 328619)
+++ phpdoc/en/trunk/reference/mysqlnd/stats.xml 2012-12-03 07:29:14 UTC (rev 328620)
@@ -143,10 +143,8 @@
<function>mysqli_get_connection_stats</function> and
<function>mysqli_get_cache_stats</function> functions.
</para>
- <para>
- <emphasis role="bold">Network</emphasis>
- </para>
- <informaltable>
+ <table>
+ <title>Returned mysqlnd statistics: Network</title>
<tgroup cols="4">
<colspec colwidth="10*"/>
<colspec colwidth="10*"/>
@@ -416,11 +414,12 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
<emphasis role="bold">Result Set</emphasis>
</para>
- <informaltable>
+ <table>
+ <title>Returned mysqlnd statistics: Result Set</title>
<tgroup cols="4">
<colspec colwidth="10*"/>
<colspec colwidth="10*"/>
@@ -891,11 +890,9 @@
</row>
</tbody>
</tgroup>
- </informaltable>
- <para>
- <emphasis role="bold">Connection</emphasis>
- </para>
- <informaltable>
+ </table>
+ <table>
+ <title>Returned mysqlnd statistics: Connection</title>
<tgroup cols="4">
<colspec colwidth="10*"/>
<colspec colwidth="10*"/>
@@ -1039,11 +1036,9 @@
</row>
</tbody>
</tgroup>
- </informaltable>
- <para>
- <emphasis role="bold">COM_* Commands</emphasis>
- </para>
- <informaltable>
+ </table>
+ <table>
+ <title>Returned mysqlnd statistics: COM_* Command</title>
<tgroup cols="4">
<colspec colwidth="10*"/>
<colspec colwidth="10*"/>
@@ -1127,11 +1122,12 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
<para>
<emphasis role="bold">Miscellaneous</emphasis>
</para>
- <informaltable>
+ <table>
+ <title>Returned mysqlnd statistics: Miscellaneous</title>
<tgroup cols="4">
<colspec colwidth="10*"/>
<colspec colwidth="10*"/>
@@ -1236,7 +1232,7 @@
</row>
</tbody>
</tgroup>
- </informaltable>
+ </table>
</chapter>
<!-- Keep this comment at the end of the file
Local variables: