Merged revisions 80587 via svnmerge from

svn+ssh://pythondev@svn.python.org/python/branches/py3k

................
  r80587 | senthil.kumaran | 2010-04-28 23:09:48 +0530 (Wed, 28 Apr 2010) | 9 lines

  Merged revisions 80583 via svnmerge from
  svn+ssh://pythondev@svn.python.org/python/trunk

  ........
    r80583 | senthil.kumaran | 2010-04-28 22:50:43 +0530 (Wed, 28 Apr 2010) | 3 lines

    Fixed Issue6312 - httplib fails with HEAD requests to pages with "transfer-encoding: chunked"
  ........
................

1 files changed, 16 insertions, 0 deletions

diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst
index 0b41327..737ba15 100644
--- a/Doc/library/http.client.rst
+++ b/Doc/library/http.client.rst
@@ -504,6 +504,22 @@ Here is an example session that uses the ``GET`` method::
    >>> data2 = r2.read()
    >>> conn.close()
 
+Here is an example session that uses ``HEAD`` method. Note that ``HEAD`` method
+never returns any data. ::
+
+
+   >>> import http.client
+   >>> conn = http.client.HTTPConnection("www.python.org")
+   >>> conn.request("HEAD","/index.html")
+   >>> res = conn.getresponse()
+   >>> print(res.status, res.reason)
+   200 OK
+   >>> data = res.read()
+   >>> print(len(data))
+   0
+   >>> data == b''
+   True
+
 Here is an example session that shows how to ``POST`` requests::
 
    >>> import http.client, urllib.parse