philip Tue Apr 12 03:19:49 2005 EDT
Modified files:
/phpdoc/en/appendices about.xml
Log:
Mention that features are added in major releases, not minor ones. And
that the manual is written in present, not future tense.
Although this won't eliminate bugs like #32679 it may help.
http://cvs.php.net/diff.php/phpdoc/en/appendices/about.xml?r1=1.40&r2=1.41&ty=u
Index: phpdoc/en/appendices/about.xml
diff -u phpdoc/en/appendices/about.xml:1.40 phpdoc/en/appendices/about.xml:1.41
--- phpdoc/en/appendices/about.xml:1.40 Tue Mar 1 11:04:18 2005
+++ phpdoc/en/appendices/about.xml Tue Apr 12 03:19:49 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.40 $ -->
+<!-- $Revision: 1.41 $ -->
<appendix id="about">
<title>About the manual</title>
@@ -281,6 +281,12 @@
is 4.3.x). Most of the time, this is not an error in the documentation.
Explanation is often added for features not available in the current
PHP release, but which will be available in a known future PHP version.
+ Typically, PHP only adds new features in major releases otherwise only bugs
+ are fixed. Using the A.B.C versioning format, a major release increments A
+ or B whereas minor releases increment C. So for example it's not uncommon
+ for a feature to be documented as available in PHP x.1.x when the latest
+ release is PHP x.0.x. Also note that the manual is written in present
+ tense, not future tense.
</para>
<para>
Many times the PHP manual lists "Default Values" for PHP directives. These
