php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #53560 link() confusing parameter description
Submitted: 2010-12-16 23:29 UTC Modified: 2011-02-10 15:03 UTC
From: filip at kobylisy dot net Assigned: frozenfire (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Developer Edit
 [2010-12-16 23:29 UTC] filip at kobylisy dot net 
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

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2011-01-13 20:03 UTC] frozenfire@php.net
-Assigned To: +Assigned To: frozenfire
 [2011-02-10 15:03 UTC] vrana@php.net
-Status: Assigned +Status: Closed
 [2011-02-10 15:03 UTC] vrana@php.net 
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.
 [2011-02-10 15:03 UTC] vrana@php.net 
Automatic comment from SVN on behalf of vrana
Revision: http://svn.php.net/viewvc/?view=revision&revision=308193
Log: Rename parameters (doc bug #53560)
 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved. 		Last updated: Thu Oct 08 08:00:01 2026 UTC