Re: Proposal: add strikethrough effect to removed functions and gray out deprecated functions in function lists
| From: | Sherif Ramadan | Date: | Tue, 12 Nov 2013 15:27:23 +0000 |
| Subject: | Re: Proposal: add strikethrough effect to removed functions and gray out deprecated functions in function lists | ||
| References: | 1 2 3 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969384725@lists.php.net to get a copy of this message | ||
On Tue, Nov 12, 2013 at 10:23 AM, Andrea Faulds <ajf@ajf.me> 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.
>
>
>
It doesn't make it obvious when the function was removed. It could end up
being more confusing than helpful. Don't forget that php.net also documents
PECL extensions. I'm not sure how difficult it would be to pull that off
trying to generate the CSS.