go to bug id or search bugs for
From manual page: http://www.php.net/function.delete#refsect1-function.delete-description
This documentation entry has wording that could be considered judegemental and/or insulting. It is unnecessary to state the the entry for delete is a 'dummy' entry to 'satisfy' those looking the 'wrong' place. The wording for this entry is very condescending and has no place in technical documentation.
A simple statement that the page has been redirected from another is all that is needed. A good example of how this kind of thing should be done can be found at Wikipedia.com.
Add a Patch
Add a Pull Request
I believe you've misinterpreted the use of the word "dummy" here: it's in the
adjective meaning of "placeholder", not the vaguely insulting noun form.
Yes, I understand the usage of that particular word. That word, in and of itself
is not the issue. The primary issue is that the phrase
"This is a dummy manual entry to satisfy those people who are looking for
unlink() or unset() in the wrong place."
is unnecessarily condescending, as though your are speaking to an annoying
sibling or co-worker. The secondary, and perhaps most important issue is that it
is simply technically incorrect: one need not "look in the wrong place" for this
term, one simply types the word 'delete' into the search field on the PHP
documentation web page and this entry is presented TO them.
The word 'delete' is a perfectly reasonable word to search for in a programming
language reference. If it is not a valid term for the reference being searched,
then display a message notifying the searcher of that fact. Do not assume that
you have determined the "true meaning" of their inquiry, produce a result, and
then proceed to tell them that THEY have looked in the WRONG place!