summaryrefslogtreecommitdiffstats
path: root/Doc/library/urllib.parse.rst
diff options
context:
space:
mode:
authorMartin Panter <vadmium+py@gmail.com>2015-11-24 22:59:28 (GMT)
committerMartin Panter <vadmium+py@gmail.com>2015-11-24 22:59:28 (GMT)
commita561c038ab336597652c9074818293ddfc65a25d (patch)
tree707afa72c0dcd9c19ffa0510b5eaf12acf66283d /Doc/library/urllib.parse.rst
parent33623b145df4d41f49ab3ae9e781135fb87fd98d (diff)
parentf7e8d07538a1734bdb0438ab53e0a54db456d4d9 (diff)
downloadcpython-a561c038ab336597652c9074818293ddfc65a25d.zip
cpython-a561c038ab336597652c9074818293ddfc65a25d.tar.gz
cpython-a561c038ab336597652c9074818293ddfc65a25d.tar.bz2
Issue #25576: Merge www-form-urlencoded doc from 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 7c075ad..0008740 100644
--- a/Doc/library/urllib.parse.rst
+++ b/Doc/library/urllib.parse.rst
@@ -535,10 +535,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*