summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2011-07-01 01:24:39 -0400
committerChris McDonough <chrism@plope.com>2011-07-01 01:24:39 -0400
commitb7f33b5fdd062e007723d0eb60001442f35c0bf7 (patch)
tree4f94a0c78f558564de4e3bccb02aba2b5e125f00 /docs
parent6579f51fec8506332cdd61d06ed20178f0bdfbcb (diff)
downloadpyramid-b7f33b5fdd062e007723d0eb60001442f35c0bf7.tar.gz
pyramid-b7f33b5fdd062e007723d0eb60001442f35c0bf7.tar.bz2
pyramid-b7f33b5fdd062e007723d0eb60001442f35c0bf7.zip
- Deprecated the ``set_renderer_globals_factory`` method of the Configurator
and the ``renderer_globals`` Configurator constructor parameter.
Diffstat (limited to 'docs')
-rw-r--r--docs/api/config.rst2
-rw-r--r--docs/narr/hooks.rst7
-rw-r--r--docs/whatsnew-1.1.rst6
3 files changed, 11 insertions, 4 deletions
diff --git a/docs/api/config.rst b/docs/api/config.rst
index 274ee0292..71ef4a746 100644
--- a/docs/api/config.rst
+++ b/docs/api/config.rst
@@ -74,7 +74,7 @@
.. automethod:: set_request_factory
- .. automethod:: set_renderer_globals_factory
+ .. automethod:: set_renderer_globals_factory(factory)
.. automethod:: set_view_mapper
diff --git a/docs/narr/hooks.rst b/docs/narr/hooks.rst
index 1c8a64fd7..56c566a4c 100644
--- a/docs/narr/hooks.rst
+++ b/docs/narr/hooks.rst
@@ -183,6 +183,10 @@ already constructed a :term:`configurator` it can also be registered via the
Adding Renderer Globals
-----------------------
+.. warning:: this feature is deprecated as of Pyramid 1.1. A non-deprecated
+ mechanism which allows event subscribers to add renderer global values
+ is documented in :ref:`beforerender_event`.
+
Whenever :app:`Pyramid` handles a request to perform a rendering (after a
view with a ``renderer=`` configuration attribute is invoked, or when any
of the methods beginning with ``render`` within the :mod:`pyramid.renderers`
@@ -227,9 +231,6 @@ already constructed a :term:`configurator` it can also be registered via the
config = Configurator()
config.set_renderer_globals_factory(renderer_globals_factory)
-Another mechanism which allows event subscribers to add renderer global values
-exists in :ref:`beforerender_event`.
-
.. index::
single: before render event
diff --git a/docs/whatsnew-1.1.rst b/docs/whatsnew-1.1.rst
index 7d0f666d3..3252cba22 100644
--- a/docs/whatsnew-1.1.rst
+++ b/docs/whatsnew-1.1.rst
@@ -364,6 +364,12 @@ Deprecations and Behavior Differences
within a static view returns the index.html properly. See also
https://github.com/Pylons/pyramid/issues/67.
+- Deprecated the
+ :meth:`pyramid.config.Configurator.set_renderer_globals_factory` method and
+ the ``renderer_globals`` Configurator constructor parameter. Users should
+ use convert code using this feature to use a BeforeRender event als
+ :ref:`beforerender_event`.
+
Dependency Changes
------------------