From: Zachary Ware <zachary.ware@gmail.com>
Date: Wed, 24 May 2017 21:11:21 +0000 (-0500)
Subject: [3.5] bpo-30160: Clarify intended usage of wfile (gh-1300) (GH-1792)
X-Git-Tag: v3.5.4rc1~129
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=aa27f0e94f4d9c5ef589984dc2b32d856e8e038f;p=thirdparty%2FPython%2Fcpython.git

[3.5] bpo-30160: Clarify intended usage of wfile (gh-1300) (GH-1792)

The library does not enforce compliance with the HTTP protocol,
so violations are not technically disallowed. Extend the stream's
description to avoid suggesting that intentional protocol violations are
not supported.
(cherry picked from commit a083c8e)
---

diff --git a/Doc/library/http.server.rst b/Doc/library/http.server.rst
index ae7fb970de1e..6e71c8a88111 100644
--- a/Doc/library/http.server.rst
+++ b/Doc/library/http.server.rst
@@ -105,7 +105,8 @@ of which this module provides three different variants:
 
       Contains the output stream for writing a response back to the
       client. Proper adherence to the HTTP protocol must be used when writing to
-      this stream.
+      this stream in order to achieve successful interoperation with HTTP
+      clients.
 
    :class:`BaseHTTPRequestHandler` has the following attributes: