]> granicus.if.org Git - python/commitdiff
documented (new) optional doseq parameter to urlencode.
authorSkip Montanaro <skip@pobox.com>
Wed, 24 Jan 2001 06:36:06 +0000 (06:36 +0000)
committerSkip Montanaro <skip@pobox.com>
Wed, 24 Jan 2001 06:36:06 +0000 (06:36 +0000)
Doc/lib/liburllib.tex

index 7fe68cfad92cc0df59f71b0cf77a3e12e6ee7deb..efceb8ac5f2eaa2e9ce22385ef9e00d3a6ae8c36 100644 (file)
@@ -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