2008/9/25 Philip Olson <[EMAIL PROTECTED]>: > philip Thu Sep 25 17:59:32 2008 UTC > > Added files: > /phpdoc/en/reference/dio versions.xml > Log: > Version information for ext/dio > # Split from phpdoc/phpbook/phpbook-xsl/version.xml > > > > http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dio/versions.xml?view=markup&rev=1.1 > Index: phpdoc/en/reference/dio/versions.xml > +++ phpdoc/en/reference/dio/versions.xml > <?xml version='1.0' encoding='utf-8'?> > <!-- > Do NOT translate this file > --> > <versions> > <function name='dio_close' from='PHP 4 >= 4.2.0, PHP 5 <= 5.0.5'/> > <function name='dio_fcntl' from='PHP 4 >= 4.2.0, PHP 5 <= 5.0.5'/> > <function name='dio_open' from='PHP 4 >= 4.2.0, PHP 5 <= 5.0.5'/> > <function name='dio_read' from='PHP 4 >= 4.2.0, PHP 5 <= 5.0.5'/> > <function name='dio_seek' from='PHP 4 >= 4.2.0, PHP 5 <= 5.0.5'/> > <function name='dio_stat' from='PHP 4 >= 4.2.0, PHP 5 <= 5.0.5'/> > <function name='dio_tcsetattr' from='PHP 4 >= 4.3.0, PHP 5 <= 5.0.5'/> > <function name='dio_truncate' from='PHP 4 >= 4.2.0, PHP 5 <= 5.0.5'/> > <function name='dio_write' from='PHP 4 >= 4.2.0, PHP 5 <= 5.0.5'/> > </versions>
I forgot to mention this in the TODO thread, but this is one of the outstanding TODOs indeed. The reason this is "needed" is to make it easier to identify bugs in the version info and simpler to upgrade for humans. Furthermore chunking it makes it heckofalot clearer where to find the info and - in the end - will make it possible to distribute per-extension-manuals without requiring huge "external" file to build the version info. The problem however is that PhD has no knowledge of which "chunked file" (i.e. en/reference/dio/book.xml, en/reference/http/book.xml..) it is parsing and therefore cannot figure out which versions.xml file it should use. The reason for that is our dumb usage of file entity include magic which we should replace with XInclude in the near future. In the meantime, I propose we hack configure.php to find all versions.xml files and create one big one (i.e. phpbook/phpbook-xsl/versions.xml) which we then pass to PhD like usual. -Hannes
