From f0769e8bd0cc4bad1641e5558787a6006d7b63b2 Mon Sep 17 00:00:00 2001 From: Senthil Kumaran Date: Mon, 9 Aug 2010 19:53:52 +0000 Subject: Fix Issue7007 - Use percent-encoded consistently instead of URL Encoded variations. Docs changed. --- Doc/faq/library.rst | 2 +- Doc/library/logging.rst | 2 +- Doc/library/urllib.parse.rst | 6 +++--- Doc/library/urllib.request.rst | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/Doc/faq/library.rst b/Doc/faq/library.rst index 2824330..5965b6a 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 6941ce7..2dd6713 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 b915f29..8fe7f19 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 0ac228d..0755415 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*. -- cgit v0.12