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

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

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 fb5c1df611d8..b29020bc7ca5 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.
 
       .. versionchanged:: 3.6
          This is an :class:`io.BufferedIOBase` stream.