diff --git a/appendices/about.xml b/appendices/about.xml
index 4bca4a45b3..dbf722feea 100644
--- a/appendices/about.xml
+++ b/appendices/about.xml
@@ -268,34 +268,40 @@ Returns the length of given string.
whereas the latest is PHP 5.x.x.
- Documentation partly exists for the SVN version of PHP, which
- always means the very latest development version. This has yet to
- be released so is only available through the SVN version handling system,
- or via a snapshot. So be aware that
- features marked "available in SVN" are typically unavailable. These
- features, though, will most likely be available in the next stable version
- of PHP. To download the SVN version, see the anonymous
- SVN access page.
+ When documentation exists for the latest (unreleased) developmental versions
+ of PHP, it will be labeled as either "available in SVN" or "development
+ version." And while these changes should be planned for, in rare cases they
+ may change.
- So, documentation may exist for PHP versions that aren't yet released.
- (Something like PHP 6.x.x while the latest stable version might be
- 5.x.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 will be available as 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.
+ All development takes place in Subversion (SVN) and may be checked out
+ as described within the anonymous SVN
+ access page. Or, these same sources may be downloaded as
+ PHP snapshots, which are available
+ for every active PHP branch.
+
+
+ And to clarify, the manual will refer to major, minor and point PHP releases.
+ Using PHP 5.3.1 as an example, the 5
+ refers to the major version, 3 to minor, and
+ 1 is the point release. Typically PHP only adds new features
+ to major and minor releases, and fixes bugs in point releases. However, this
+ convention is not always true.
+
+
+ Also note that the PHP manual is written in present tense, not future tense,
+ even for documented features that are not yet available. The reason for this
+ is so the manual can stand the test of time, thus not require tedious grammar
+ updates with every PHP release.
Many times the PHP manual lists "Default Values" for PHP directives. These
- values are based on php.ini-development and not
- php.ini-production. They also refer to the latest
- version of PHP. See the PHP directive
- appendix for details on these values and changes.
+ values are based on how PHP behaves without a &php.ini; configuration file,
+ so this may differ from values found in the distributed
+ php.ini-development and php.ini-production
+ files. They also refer to the latest version of PHP, although changelog entries
+ do mention past values. See the PHP directive
+ appendix for details regarding these values and changes.