summaryrefslogtreecommitdiffstats
path: root/Doc/library/urllib.parse.rst
diff options
context:
space:
mode:
authorMartin Panter <vadmium+py@gmail.com>2015-11-24 22:57:46 (GMT)
committerMartin Panter <vadmium+py@gmail.com>2015-11-24 22:57:46 (GMT)
commitf7e8d07538a1734bdb0438ab53e0a54db456d4d9 (patch)
tree623f16d6b62025309c0041c3b053179fe3cf8125 /Doc/library/urllib.parse.rst
parent6e701310d111452fa63de967ea8c624dd391167d (diff)
parentcda85a0d1ca217c927211af799072c85b04b4e89 (diff)
downloadcpython-f7e8d07538a1734bdb0438ab53e0a54db456d4d9.zip
cpython-f7e8d07538a1734bdb0438ab53e0a54db456d4d9.tar.gz
cpython-f7e8d07538a1734bdb0438ab53e0a54db456d4d9.tar.bz2
Issue #25576: Merge www-form-urlencoded doc from 3.4 into 3.5
Diffstat (limited to 'Doc/library/urllib.parse.rst')
-rw-r--r--Doc/library/urllib.parse.rst9
1 files changed, 5 insertions, 4 deletions
diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst
index 40098d0..21c82f5 100644
--- a/Doc/library/urllib.parse.rst
+++ b/Doc/library/urllib.parse.rst
@@ -525,10 +525,11 @@ task isn't already covered by the URL parsing functions above.
errors=None, quote_via=quote_plus)
Convert a mapping object or a sequence of two-element tuples, which may
- contain :class:`str` or :class:`bytes` objects, to a "percent-encoded"
- string. If the resultant string is to be used as a *data* for POST
- operation with :func:`~urllib.request.urlopen` function, then it should be
- properly encoded to bytes, otherwise it would result in a :exc:`TypeError`.
+ contain :class:`str` or :class:`bytes` objects, to a percent-encoded ASCII
+ text string. If the resultant string is to be used as a *data* for POST
+ operation with the :func:`~urllib.request.urlopen` function, then
+ it should be encoded to bytes, otherwise it would result in a
+ :exc:`TypeError`.
The resulting string is a series of ``key=value`` pairs separated by ``'&'``
characters, where both *key* and *value* are quoted using the *quote_via*