Doc #62762 [Opn->Wfx]: Incorrect/unnecessary verbage

From: Date: Tue, 07 Aug 2012 01:20:10 +0000
Subject: Doc #62762 [Opn->Wfx]: Incorrect/unnecessary verbage
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-8706@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=62762&edit=1 ID: 62762 Updated by: aharvey@php.net Reported by: tom at happyalienproductions dot com Summary: Incorrect/unnecessary verbage -Status: Open +Status: Wont fix Type: Documentation Problem Package: Filesystem function related Operating System: Windows 7 PHP Version: 5.3.15 Block user comment: N Private report: N New Comment: 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. Previous Comments: ------------------------------------------------------------------------ [2012-08-06 20:36:52] tom at happyalienproductions dot com Description: ------------ --- 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. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=62762&edit=1

« previous php.doc.bugs (#8706) next »