Edit comments to discourage creation of new OutputTransforms.

diff --git a/tornado/web.py b/tornado/web.py
index cd0232192934eb269912f5f957bb6a2a20453d08..506caae7538189aab6ccd7a5935767d0336d05c2 100644 (file)
--- a/tornado/web.py
+++ b/tornado/web.py
@@ -2501,9 +2501,9 @@ class FallbackHandler(RequestHandler):
 class OutputTransform(object):
     """A transform modifies the result of an HTTP request (e.g., GZip encoding)
 
-    A new transform instance is created for every request. See the
-    GZipContentEncoding example below if you want to implement a
-    new Transform.
+    Applications are not expected to create their own OutputTransforms
+    or interact with them directly; the framework chooses which transforms
+    (if any) to apply.
     """
     def __init__(self, request):
         pass