Doc #62762 [NEW]: Incorrect/unnecessary verbage

From: Date: Mon, 06 Aug 2012 20:36:53 +0000
Subject: Doc #62762 [NEW]: Incorrect/unnecessary verbage
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-8704@lists.php.net to get a copy of this message
From: tom at happyalienproductions dot com Operating system: Windows 7 PHP version: 5.3.15 Package: Filesystem function related Bug Type: Documentation Problem Bug description:Incorrect/unnecessary verbage 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 bug report at https://bugs.php.net/bug.php?id=62762&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=62762&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=62762&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=62762&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=62762&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=62762&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=62762&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=62762&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=62762&r=needscript Try newer version: https://bugs.php.net/fix.php?id=62762&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=62762&r=support Expected behavior: https://bugs.php.net/fix.php?id=62762&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=62762&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=62762&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=62762&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=62762&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=62762&r=dst IIS Stability: https://bugs.php.net/fix.php?id=62762&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=62762&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=62762&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=62762&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=62762&r=mysqlcfg

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