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 Developer Edit
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: php-bugs at allenjb dot me dot uk
New email:
PHP Version: OS:

 

 [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

Pull Requests

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-2025 The PHP Group
All rights reserved. 		Last updated: Thu Mar 13 00:01:31 2025 UTC