Current wording follows parameters order.

vrana@php.net Closed this bug saying:

"Current wording follows parameters order."

Respectfully:

1) At the very least, the word "from" should be changed to the word "to".

2) If the parameter names were listed in column 1 of a table, with descriptions in column 2, then I agree that they should be listed in order.

3) However, as the description of the parameters is a single English sentence, I believe that sentence should be written for clarity.

4) The symlink man pages on both Linux and FreeBSD list the parameters in reverse order, and are both much clearer than the PHP docs.  I prefer the Linux version.

Linux:

int symlink(const char *oldpath, const char *newpath);

symlink() creates a symbolic link named newpath which contains the string oldpath.

FreeBSD:

int symlink(const char *name1, const char *name2);

A symbolic link name2 is created to name1 (name2 is the name of the file created, name1 is the string used in creating the symbolic link).

I will not reopen this bug again.  Thank you!

My symlink man page says:

int symlink(const char *name1, const char *name2);
A symbolic link name2 is created to name1

The order of the parameters doesn't necessarily have to dictate the order in which they appear in a sentence describing them, as we can see from above. However, rewording the sentence as it is in the PHP manual is unnecessary. Simply changing the word "from" to "to" will add sufficient clarity, so that is what I have done.