ID: 28295 User updated by: m at bytech dot fi Reported By: m at bytech dot fi Status: Open Bug Type: Documentation problem PHP Version: Irrelevant New Comment:
I imagine this could initially be done so that the version information that already exists in the current documentation would be automatically parsed, and then the remaining version information could be applied later. And the version checking could also be done by a community effort. I'm not familiar with the documentation system that the php.net docs use, but the version data that is already available there is pretty extensive (especially with PHP5 specific functions), and generally speaking in a format that could easily be automatically parsed from the documentation. And of course, good things often require some effort. :) Previous Comments: ------------------------------------------------------------------------ [2004-05-06 10:24:20] [EMAIL PROTECTED] Would be good, but also a lot of effort for the doc team to audit the whole text. I'm not even sure if DocBook has a way to version sections of text. ------------------------------------------------------------------------ [2004-05-06 09:55:16] m at bytech dot fi Description: ------------ It would be very helpful if it was possible to better distinguish PHP5 specific functions when browsing the documentation. A lot of people will be coding for PHP4 for quite some time, and showing functions that are only available in PHP5 or in CVS might be confusing to them. Of course the version compatibility of the function is displayed on the top of every help page, but this is very easy to miss. And considering the sheer amount of functions that are available, some kind of limiting would be quite beneficial. This separation could be done in several ways, for example: - Separate documentations in different locations - Through a "My php.net" setting - Displaying new functions in different color - Hiding new functions completely This setting could naturally also be used to otherwise customize the help system, for example hiding functions for extensions that are rarely used, or setting the preferred PHP version number and showing only the functions that are relevant to that version, etc. ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=28295&edit=1
