diff options
| -rw-r--r-- | pyramid/config.py | 11 |
1 files changed, 9 insertions, 2 deletions
diff --git a/pyramid/config.py b/pyramid/config.py index 057282838..29da51875 100644 --- a/pyramid/config.py +++ b/pyramid/config.py @@ -463,7 +463,7 @@ class Configurator(object): :meth:`pyramid.config.Configuration.commit` is called (or executed immediately if ``autocommit`` is ``True``). - .. note:: This method is typically only used by :app:`Pyramid` + .. warning:: This method is typically only used by :app:`Pyramid` framework extension authors, not by :app:`Pyramid` application developers. @@ -607,6 +607,10 @@ class Configurator(object): """ Add a directive method to the configurator. + .. warning:: This method is typically only used by :app:`Pyramid` + framework extension authors, not by :app:`Pyramid` application + developers. + Framework extenders can add directive methods to a configurator by instructing their users to call ``config.add_directive('somename', 'some.callable')``. This will make ``some.callable`` accessible as @@ -808,11 +812,14 @@ class Configurator(object): def derive_view(self, view, attr=None, renderer=None): """ - Create a :term:`view callable` using the function, instance, or class (or :term:`dotted Python name` referring to the same) provided as ``view`` object. + .. warning:: This method is typically only used by :app:`Pyramid` + framework extension authors, not by :app:`Pyramid` application + developers. + This is API is useful to framework extenders who create pluggable systems which need to register 'proxy' view callables for functions, instances, or classes which meet the |