Doc #52638 [NEW]: Misleading parameter name for http_build_query
| From: | marcus at deglos dot com | Date: | Wed, 18 Aug 2010 20:32:01 +0000 |
| Subject: | Doc #52638 [NEW]: Misleading parameter name for http_build_query | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-4884@lists.php.net to get a copy of this message | ||
From:
Operating system: n/a
PHP version: Irrelevant
Package: Documentation problem
Bug Type: Documentation Problem
Bug description:Misleading parameter name for http_build_query
Description:
------------
The documentation for 'http_build_query' (
http://php.net/manual/en/function.http-build-query.php
) lists the first
parameter as '$formdata'.
Most uses of http_build_query don't involve forms or formdata, which makes
the parameter-name misleading. People scanning the documentation may
ignore this function, thinking that it only applies to forms (I know I've
skipped past it many a time!)
Renaming the parameter '$paramaters' or '$query_params' will help users
understand the use of this function.
Test script:
---------------
n/a
Expected result:
----------------
n/a
Actual result:
--------------
n/a
--
Edit bug report at http://bugs.php.net/bug.php?id=52638&edit=1
--
Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=52638&r=trysnapshot52
Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=52638&r=trysnapshot53
Try a snapshot (trunk): http://bugs.php.net/fix.php?id=52638&r=trysnapshottrunk
Fixed in SVN: http://bugs.php.net/fix.php?id=52638&r=fixed
Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=52638&r=needdocs
Fixed in release: http://bugs.php.net/fix.php?id=52638&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=52638&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=52638&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=52638&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=52638&r=support
Expected behavior: http://bugs.php.net/fix.php?id=52638&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=52638&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=52638&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=52638&r=globals
PHP 4 support discontinued: http://bugs.php.net/fix.php?id=52638&r=php4
Daylight Savings: http://bugs.php.net/fix.php?id=52638&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=52638&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=52638&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=52638&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=52638&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=52638&r=mysqlcfg