From: jugglinmike <mike@mikepennisi.com>
Date: Wed, 24 May 2017 18:25:50 +0000 (-0400)
Subject: bpo-30160: Clarify intended usage of wfile (gh-1300)
X-Git-Tag: v3.7.0a1~745
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a083c8ee6cb89ca573fe10c4c1922e2fa69ceaa3;p=python

bpo-30160: Clarify intended usage of wfile (gh-1300)

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.
---

diff --git a/Doc/library/http.server.rst b/Doc/library/http.server.rst
index 323ee9f5d3..c98843de02 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.