cvs: phpdoc /en/internals2 counter.xml intro.xml /en/internals2/structure modstruct.xml
| From: | Gwynne Raskind | Date: | Wed, 09 Apr 2008 07:00:28 +0000 |
| Subject: | cvs: phpdoc /en/internals2 counter.xml intro.xml /en/internals2/structure modstruct.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-1455@lists.php.net to get a copy of this message | ||
gwynne Wed Apr 9 07:00:28 2008 UTC
Modified files:
/phpdoc/en/internals2 counter.xml intro.xml
/phpdoc/en/internals2/structure modstruct.xml
Log:
Use static modifier, fix some version numbers, add more info about counter
http://cvs.php.net/viewvc.cgi/phpdoc/en/internals2/counter.xml?r1=1.1&r2=1.2&diff_format=u
Index: phpdoc/en/internals2/counter.xml
diff -u phpdoc/en/internals2/counter.xml:1.1 phpdoc/en/internals2/counter.xml:1.2
--- phpdoc/en/internals2/counter.xml:1.1 Wed Mar 12 16:39:34 2008
+++ phpdoc/en/internals2/counter.xml Wed Apr 9 07:00:27 2008
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<part xml:id="internals2.counter" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The "counter" Extension - A Continuing Example</title>
@@ -636,6 +636,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
+ <modifier>static</modifier>
<type>Counter</type><methodname>Counter::getNamed</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
http://cvs.php.net/viewvc.cgi/phpdoc/en/internals2/intro.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/internals2/intro.xml
diff -u phpdoc/en/internals2/intro.xml:1.4 phpdoc/en/internals2/intro.xml:1.5
--- phpdoc/en/internals2/intro.xml:1.4 Wed Mar 12 16:39:34 2008
+++ phpdoc/en/internals2/intro.xml Wed Apr 9 07:00:27 2008
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<!--
&internals2.buildsys.index; configure options, ext_skel, config.m4, config.w32, static vs.
dynamic builds
@@ -41,7 +41,7 @@
</warning>
<simpara>
- This section of the manual is devoted to ZE2. While PHP 4.3 is still in
+ This section of the manual is devoted to ZE2. While PHP 4.4 is still in
widespread use, the differences in how extensions are written in ZE1 are
small; a short reference to them is given in an appendix to this section.
ZE3's API may yet change significantly, and is covered in another appendix.
@@ -49,9 +49,9 @@
</simpara>
<simpara>
- The documentation in this section is current as of PHP 5.2.3, the most
+ The documentation in this section is current as of PHP 5.2.5, the most
recent stable release at the time of this writing. Notable differences in
- the minor PHP 5 releases (5.0, 5.1, and 5.2) are given as appropriate.
+ the minor PHP 5 releases (5.0 through 5.3) are given as appropriate.
</simpara>
</preface>
http://cvs.php.net/viewvc.cgi/phpdoc/en/internals2/structure/modstruct.xml?r1=1.7&r2=1.8&diff_format=u
Index: phpdoc/en/internals2/structure/modstruct.xml
diff -u phpdoc/en/internals2/structure/modstruct.xml:1.7
phpdoc/en/internals2/structure/modstruct.xml:1.8
--- phpdoc/en/internals2/structure/modstruct.xml:1.7 Sun Mar 9 20:38:44 2008
+++ phpdoc/en/internals2/structure/modstruct.xml Wed Apr 9 07:00:27 2008
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
<sect1 xml:id="internals2.structure.modstruct" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
<title>The zend_module structure</title>
<para>
@@ -463,11 +463,7 @@
<para>
With all these fields to play with, it can be confusing to know which to use
for what purpose. Here is the <literal>zend_module</literal> definition from
- a "real-world" example extension. This extension provides a
- counter that increases by one every time the function to get its current
- value is called. The time at which the counter is reset is controlled by an
- INI switch. This is useless in a practical sense, but serves to illustrate
- many techniques for extension writing.
+ the "counter" example extension.
</para>
<example xml:id="internals2.structure.modstruct.filling-it-in.counter-mod-ex">
@@ -508,7 +504,10 @@
<listitem>
<simpara>
"counter" is the extension's name, and is used to define the
- various callback functions the module passes to Zend.
+ various callback functions the module passes to Zend. "counter" uses
+ module, globals, and request functions at startup and shutdown times, and
+ provides information to <function>phpinfo</function>, so all seven
+ callbacks are defined.
</simpara>
</listitem>
@@ -532,6 +531,13 @@
<listitem>
<simpara>
+ "counter" uses per-module globals, so
+ <constant>PHP_MODULE_GLOBALS</constant> is used
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
This module has no post-deactivate function, so &null; is used.
</simpara>
</listitem>