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?
Greetings, and meery Christmas to those who celebrate it,
Jan Fabry
