Doc #69919 [Opn->Wfx]: php_check_syntax deprecation / removed notice should be more prominent

Edit report at https://bugs.php.net/bug.php?id=69919&edit=1 ID: 69919 Updated by: salathe@php.net Reported by: php-bugs at allenjb dot me dot uk Summary: php_check_syntax deprecation / removed notice should be more prominent -Status: Open +Status: Wont fix Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant Block user comment: N Private report: N New Comment: Occasinally, for exceedingly widely used features, we will show a more "in your face" message for deprecation and removal (e.g. ext/mysql, and POSIX regex). There are special cases, and were treated as such. Normally, the version information at the top of the screen, and a changelog section lower down, is all that would be used. php_check_syntax() is not really a special case, so even the current "note" in the description section is going above and beyond. If you wish to add a wider change request to make the version information (particularly for deprecated/removed features?) more visible: please raise that as a new ticket. Previous Comments: ------------------------------------------------------------------------ [2015-06-24 11:52:55] cmb@php.net Well, the notice is not really about the deprecation, but rather about the removal of php_check_syntax() as of PHP 5.0.5. So any developer actually using this function is supposed to get informed about that rather soon (presumingly, nobody is developing with PHP 5.0.x anymore). I would rather suggest to make the version information (directly below the heading) more prominent for all functions. ------------------------------------------------------------------------ [2015-06-24 10:20:02] php-bugs at allenjb dot me dot uk Description: ------------ The deprecation notice on this page is only a note box at the bottom of the main documentation, and as such is easy to miss. I would expect it to be a more prominent notice at the top of the page (similar to what's used for the ext/mysql functions). ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=69919&edit=1