summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOlaf Alders <olaf@wundersolutions.com>2015-07-07 15:33:23 -0400
committerKaren Etheridge <ether@cpan.org>2015-07-07 13:42:18 -0700
commitd221683e3f8080d9161c3880f8113dea14ba958a (patch)
tree88c6a235e98bfae5812228269d0af35ed24d3c7d
parentdf8bf9efb26317f9b34418915b7fb81bd4f85045 (diff)
downloaduri-d221683e3f8080d9161c3880f8113dea14ba958a.tar.gz
Clarify how query_param method is to be used.
-rw-r--r--Changes1
-rw-r--r--lib/URI/QueryParam.pm11
2 files changed, 12 insertions, 0 deletions
diff --git a/Changes b/Changes
index 1a05b26..5d5750c 100644
--- a/Changes
+++ b/Changes
@@ -6,6 +6,7 @@ Revision history for URI
Olaf Alders:
- add missing documentation for URI::sftp
+ - Clarify use of query_param() method
2015-06-25 Karen Etheridge <ether@cpan.org>
diff --git a/lib/URI/QueryParam.pm b/lib/URI/QueryParam.pm
index 545ff59..7866f79 100644
--- a/lib/URI/QueryParam.pm
+++ b/lib/URI/QueryParam.pm
@@ -141,6 +141,17 @@ parameters with the given key. If any of the values provided are
array references, then the array is dereferenced to get the actual
values.
+Please note that you can supply multiple values to this method, but you cannot
+supply multiple keys.
+
+Do this:
+
+ $uri->query_param( widget_id => 1, 5, 9 );
+
+Do NOT do this:
+
+ $uri->query_param( widget_id => 1, frobnicator_id => 99 );
+
=item $u->query_param_append($key, $value,...)
Adds new parameters with the given