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

From: Date: Sun, 10 Jan 2010 11:10:35 +0000
Subject: #50712 [NEW]: The list function manual page does not describe what function actually does
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-3662@lists.php.net to get a copy of this message
From:             alex dot henriet at gmail dot com
Operating system: Irrelevant
PHP version:      Irrelevant
PHP Bug Type:     Documentation problem
Bug description:  The list function manual page does not describe what function actually does

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 bug report at http://bugs.php.net/?id=50712&edit=1
-- 
Try a snapshot (PHP 5.2):            http://bugs.php.net/fix.php?id=50712&r=trysnapshot52
Try a snapshot (PHP 5.3):            http://bugs.php.net/fix.php?id=50712&r=trysnapshot53
Try a snapshot (PHP 6.0):            http://bugs.php.net/fix.php?id=50712&r=trysnapshot60
Fixed in SVN:                        http://bugs.php.net/fix.php?id=50712&r=fixed
Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=50712&r=needdocs
Fixed in release:                    http://bugs.php.net/fix.php?id=50712&r=alreadyfixed
Need backtrace:                      http://bugs.php.net/fix.php?id=50712&r=needtrace
Need Reproduce Script:               http://bugs.php.net/fix.php?id=50712&r=needscript
Try newer version:                   http://bugs.php.net/fix.php?id=50712&r=oldversion
Not developer issue:                 http://bugs.php.net/fix.php?id=50712&r=support
Expected behavior:                   http://bugs.php.net/fix.php?id=50712&r=notwrong
Not enough info:                     http://bugs.php.net/fix.php?id=50712&r=notenoughinfo
Submitted twice:                     http://bugs.php.net/fix.php?id=50712&r=submittedtwice
register_globals:                    http://bugs.php.net/fix.php?id=50712&r=globals
PHP 4 support discontinued:          http://bugs.php.net/fix.php?id=50712&r=php4
Daylight Savings:                    http://bugs.php.net/fix.php?id=50712&r=dst
IIS Stability:                       http://bugs.php.net/fix.php?id=50712&r=isapi
Install GNU Sed:                     http://bugs.php.net/fix.php?id=50712&r=gnused
Floating point limitations:          http://bugs.php.net/fix.php?id=50712&r=float
No Zend Extensions:                  http://bugs.php.net/fix.php?id=50712&r=nozend
MySQL Configuration Error:           http://bugs.php.net/fix.php?id=50712&r=mysqlcfg



Thread (3 messages)

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