I was thinking about adding version info in the documentation. If we encode version info in attributes of the documentation, we can generate multiple version of the manual, for example for PHP 4 and PHP 5, from the same source.
Instead of:
<para>In PHP 4, blah blah.</para> <para>But in PHP 5, bleh bleh.</para>
You would get:
<para version="4">blah blah.</para> <para version="5">bleh bleh.</para>
Then we could choose to generate manuals for PHP 4 only, or PHP 5 only, or maybe just PHP 4.3.0, ...
This would also reduce confusion with changing function prototypes, new functions, CVS-only stuff, ...
Of course, we could also add ranges, like version-from and version-until.
This would require a little extension to the DocBook DTD, but more importantly a (big) change in the build process.
It's just an idea, any reactions?
This came up many times before, and the conclusion was that it is harder to implement than what we gain from it. We would need to choose the version for the online manual, and then the user notes need to be versioned, etc... Also this would give the impression that if you download a manual for PHP 4.3.4, that will not get updated later, since it was for that particular version... But we still add info for PHP 4.2.x...
Goba
