summaryrefslogtreecommitdiffstats
path: root/Doc/lib
diff options
context:
space:
mode:
authorSkip Montanaro <skip@pobox.com>2001-01-24 06:36:06 (GMT)
committerSkip Montanaro <skip@pobox.com>2001-01-24 06:36:06 (GMT)
commiteda28445c075102690710e3775b7f419669eb653 (patch)
tree2621807a5085c5179e6f133aa711bfd6710f8c65 /Doc/lib
parent17ab123cf1f0597e7e257c1ce83a6e87b85ffd7b (diff)
downloadcpython-eda28445c075102690710e3775b7f419669eb653.zip
cpython-eda28445c075102690710e3775b7f419669eb653.tar.gz
cpython-eda28445c075102690710e3775b7f419669eb653.tar.bz2
documented (new) optional doseq parameter to urlencode.
Diffstat (limited to 'Doc/lib')
-rw-r--r--Doc/lib/liburllib.tex6
1 files changed, 4 insertions, 2 deletions
diff --git a/Doc/lib/liburllib.tex b/Doc/lib/liburllib.tex
index 7fe68cf..efceb8a 100644
--- a/Doc/lib/liburllib.tex
+++ b/Doc/lib/liburllib.tex
@@ -143,14 +143,16 @@ Like \function{unquote()}, but also replaces plus signs by spaces, as
required for unquoting HTML form values.
\end{funcdesc}
-\begin{funcdesc}{urlencode}{dict}
+\begin{funcdesc}{urlencode}{dict\optional{, doseq}}
Convert a dictionary to a ``url-encoded'' string, suitable to pass to
\function{urlopen()} above as the optional \var{data} argument. This
is useful to pass a dictionary of form fields to a \code{POST}
request. The resulting string is a series of
\code{\var{key}=\var{value}} pairs separated by \character{\&}
characters, where both \var{key} and \var{value} are quoted using
-\function{quote_plus()} above.
+\function{quote_plus()} above. If the optional parameter \var{doseq} is
+present and evaluates to true, individual \code{\var{key}=\var{value}} pairs
+are generated for each element of the sequence.
\end{funcdesc}
The public functions \function{urlopen()} and