From: Senthil Kumaran Date: Mon, 9 Aug 2010 19:53:52 +0000 (+0000) Subject: Fix Issue7007 - Use percent-encoded consistently instead of URL Encoded variations... X-Git-Tag: v3.2a2~385 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f0769e8bd0cc4bad1641e5558787a6006d7b63b2;p=thirdparty%2FPython%2Fcpython.git Fix Issue7007 - Use percent-encoded consistently instead of URL Encoded variations. Docs changed. --- diff --git a/Doc/faq/library.rst b/Doc/faq/library.rst index 282433085f70..5965b6a76fbc 100644 --- a/Doc/faq/library.rst +++ b/Doc/faq/library.rst @@ -666,7 +666,7 @@ Yes. Here's a simple example that uses urllib.request:: '/cgi-bin/some-cgi-script', data=qs) msg, hdrs = req.read(), req.info() -Note that in general for URL-encoded POST operations, query strings must be +Note that in general for a percent-encoded POST operations, query strings must be quoted by using :func:`urllib.parse.urlencode`. For example to send name="Guy Steele, Jr.":: diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 6941ce7aaaa5..2dd671355b83 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -2373,7 +2373,7 @@ supports sending logging messages to a Web server, using either ``GET`` or .. method:: emit(record) - Sends the record to the Web server as an URL-encoded dictionary. + Sends the record to the Web server as a percent-encoded dictionary. .. _formatter-objects: diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst index b915f29498f0..8fe7f190a6dc 100644 --- a/Doc/library/urllib.parse.rst +++ b/Doc/library/urllib.parse.rst @@ -117,7 +117,7 @@ The :mod:`urllib.parse` module defines the following functions: values are lists of values for each name. The optional argument *keep_blank_values* is a flag indicating whether blank - values in URL encoded queries should be treated as blank strings. A true value + values in percent-encoded queries should be treated as blank strings. A true value indicates that blanks should be retained as blank strings. The default false value indicates that blank values are to be ignored and treated as if they were not included. @@ -137,7 +137,7 @@ The :mod:`urllib.parse` module defines the following functions: name, value pairs. The optional argument *keep_blank_values* is a flag indicating whether blank - values in URL encoded queries should be treated as blank strings. A true value + values in percent-encoded queries should be treated as blank strings. A true value indicates that blanks should be retained as blank strings. The default false value indicates that blank values are to be ignored and treated as if they were not included. @@ -330,7 +330,7 @@ The :mod:`urllib.parse` module defines the following functions: .. function:: urlencode(query, doseq=False, safe='', encoding=None, errors=None) Convert a mapping object or a sequence of two-element tuples, which may - either be a :class:`str` or a :class:`bytes`, to a "url-encoded" string, + either be a :class:`str` or a :class:`bytes`, to a "percent-encoded" string, suitable to pass to :func:`urlopen` above as the optional *data* argument. This is useful to pass a dictionary of form fields to a ``POST`` request. The resulting string is a series of ``key=value`` pairs separated by ``'&'`` diff --git a/Doc/library/urllib.request.rst b/Doc/library/urllib.request.rst index 0ac228d2ad85..07554157f0e2 100644 --- a/Doc/library/urllib.request.rst +++ b/Doc/library/urllib.request.rst @@ -140,7 +140,7 @@ The :mod:`urllib.request` module defines the following functions: .. function:: url2pathname(path) - Convert the path component *path* from an encoded URL to the local syntax for a + Convert the path component *path* from a percent-encoded URL to the local syntax for a path. This does not accept a complete URL. This function uses :func:`unquote` to decode *path*.