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 323ee9f5d36e55b8cad87683c8f780fb284afb73..c98843de02cba31cf11b70693b018ec06faccda5 100644 (file)
--- 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.