Re: Proposal: add strikethrough effect to removed functions and gray out deprecated functions in function lists

On 11/12/2013 04:23 PM, Andrea Faulds wrote:

On 12/11/13 15:21, Sherif Ramadan wrote:

That's a bit misleading. Functions that were removed or deprecated from minor versions of PHP 5 still need to be documented and they should be mentioned in the Migration guide so that people are aware of any BC changes. Each function page also states at the top of the page what version of PHP the function is available in. It should also state when the function was deprecated from PHP. Those functions still need to be documented though.

Right, and I never said anything to the contrary. I am simply suggesting that we make it obvious in function lists that functions have been removed.

I agree with Serif. Anrea, note how much people uses various PHP versions. I am trying to always use latest stable PHP available when possible, but still a great amount of people use the pre 5.3 versions. While marking deprecated and removed functions for me would work, it would mislead the big group of older PHP versions users. Currently under every function name you can see information on which PHP version it is supported, ie. (PHP 4 >= 4.3.0, PHP 5). Reading further you can find information when and why it got deprecated.