From e02994b466e0f52875f32846ebcc4b523aac4431 Mon Sep 17 00:00:00 2001 From: Philip Olson Date: Tue, 12 Apr 2005 07:19:49 +0000 Subject: [PATCH] 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 --- appendices/about.xml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/appendices/about.xml b/appendices/about.xml index d8b1fee422..205fc7146d 100644 --- a/appendices/about.xml +++ b/appendices/about.xml @@ -1,5 +1,5 @@ - + About the manual @@ -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. Many times the PHP manual lists "Default Values" for PHP directives. These