Doc #62762 [NEW]: Incorrect/unnecessary verbage
| From: | tom at happyalienproductions dot com | 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