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.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@184199 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Philip Olson 2005-04-12 07:19:49 +00:00
parent a0c013fbcd
commit e02994b466

View file

@ -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 @@ Returns the length of string.
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