php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #69919 php_check_syntax deprecation / removed notice should be more prominent
Submitted: 2015-06-24 10:20 UTC Modified: 2015-06-24 13:08 UTC
From: php-bugs at allenjb dot me dot uk Assigned:
Status: Wont fix Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Have you experienced this issue?
Rate the importance of this bug to you:

 [2015-06-24 10:20 UTC] 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).

Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2015-06-24 11:52 UTC] 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 13:08 UTC] salathe@php.net
-Status: Open +Status: Wont fix
 [2015-06-24 13:08 UTC] salathe@php.net 
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.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved. 		Last updated: Fri Apr 26 03:01:32 2024 UTC