summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
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
------------------