ID:          28295
 Updated by:  [EMAIL PROTECTED]
 Reported By: m at bytech dot fi
 Status:      Open
-Bug Type:    Feature/Change Request
+Bug Type:    Documentation problem
 PHP Version: Irrelevant
 New Comment:

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.


Previous Comments:
------------------------------------------------------------------------

[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

Reply via email to