#50712 [Opn]: The list function manual page does not describe what function actually does

From: Date: Sun, 10 Jan 2010 11:22:33 +0000
Subject: #50712 [Opn]: The list function manual page does not describe what function actually does
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-3663@lists.php.net to get a copy of this message
 ID:               50712
 User updated by:  alex dot henriet at gmail dot com
 Reported By:      alex dot henriet at gmail dot com
 Status:           Open
 Bug Type:         Documentation problem
 Operating System: Irrelevant
 PHP Version:      Irrelevant
 New Comment:

Well, ok .. forget the last part, it effectively returns an array when
the variable have been assigned with the array values, but still, I
think the description in French does not describe correctly the purpose
of that language construct.


Previous Comments:
------------------------------------------------------------------------

[2010-01-10 11:10:35] alex dot henriet at gmail dot com

Description:
------------
On page http://be2.php.net/manual/fr/function.list.php,

the french description for function "list" is :

"list — Transforme une liste de variables en tableau"
meaning : list transforms a list of variables into an array.

Actually, what does that function is just the opposite ..
It assigns values coming from an array to variables that you pass as
parameters .. 

Maybe it is not only a translation problem, the return value seems
strange too .. I don't think list() is supposed to return an array.
So maybe the english page and probably others should also be fixed?




Reproduce code:
---------------
list
(PHP 4, PHP 5)
list — Transforme une liste de variables en tableau

array list  ( mixed $varname  [, mixed $...  ] )

Valeurs de retour
Retourne le tableau assigné. 

Expected result:
----------------
Irrelevant

Actual result:
--------------
Irrelevant


------------------------------------------------------------------------


-- 
Edit this bug report at http://bugs.php.net/?id=50712&edit=1



Thread (3 messages)

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