Doc #53560 [NEW]: link() confusing parameter description
| From: | filip at kobylisy dot net | Date: | Thu, 16 Dec 2010 22:29:51 +0000 |
| Subject: | Doc #53560 [NEW]: link() confusing parameter description | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-5688@lists.php.net to get a copy of this message | ||
From:
Operating system:
PHP version: Irrelevant
Package: Documentation problem
Bug Type: Documentation Problem
Bug description:link() confusing parameter description
Description:
------------
---
From manual page: http://www.php.net/function.link#Parameters
---
the parameter 1 - "from_path" is described as "The link name"
the parameter 2 - "to_path" is described as "Target of the link"
I think that it is confusing and the descriptions should be swapped. It is
inconsistent with the symlink() terminology which is correct IMHO. Maybe
renaming the parameters as $existing_file and $new_hardlink would remove
the confusion completely.
Filip
--
Edit bug report at http://bugs.php.net/bug.php?id=53560&edit=1
--
Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=53560&r=trysnapshot52
Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=53560&r=trysnapshot53
Try a snapshot (trunk): http://bugs.php.net/fix.php?id=53560&r=trysnapshottrunk
Fixed in SVN: http://bugs.php.net/fix.php?id=53560&r=fixed
Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=53560&r=needdocs
Fixed in release: http://bugs.php.net/fix.php?id=53560&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=53560&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=53560&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=53560&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=53560&r=support
Expected behavior: http://bugs.php.net/fix.php?id=53560&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=53560&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=53560&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=53560&r=globals
PHP 4 support discontinued: http://bugs.php.net/fix.php?id=53560&r=php4
Daylight Savings: http://bugs.php.net/fix.php?id=53560&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=53560&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=53560&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=53560&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=53560&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=53560&r=mysqlcfg