From 5083c3bb7445055944bd3a607d5f2f8b61e1c663 Mon Sep 17 00:00:00 2001
From: Carlos de la Guardia <cguardia@yahoo.com>
Date: Fri, 5 Aug 2011 20:31:30 -0500
Subject: Add small explanation about omitting request parameter in
 render_to_response as requested on issue 248

---
 pyramid/renderers.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/pyramid/renderers.py b/pyramid/renderers.py
index c718cf1bb..a06067c97 100644
--- a/pyramid/renderers.py
+++ b/pyramid/renderers.py
@@ -98,7 +98,9 @@ def render_to_response(renderer_name, value, request=None, package=None):
 
     Supply a ``request`` parameter in order to provide the renderer
     with the most correct 'system' values (``request`` and ``context``
-    in particular).
+    in particular). Keep in mind that if the ``request`` parameter is
+    not passed in, any changes to ``request.response`` attributes made
+    before calling this function will be ignored.
 
     """
     try:
-- 
cgit v1.2.3