From 9aac76aad6d8e40278f0aab16322bd1dbe6803bc Mon Sep 17 00:00:00 2001 From: rforkel Date: Tue, 26 Jun 2012 10:07:59 +0200 Subject: Added explanations to docstring. --- pyramid/config/views.py | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/pyramid/config/views.py b/pyramid/config/views.py index b17619356..02d5b52bf 100644 --- a/pyramid/config/views.py +++ b/pyramid/config/views.py @@ -846,6 +846,27 @@ class ViewsConfiguratorMixin(object): replacement view callable which also accepts ``(context, request)``. + If decorator is a tuple or list of callables, the callables will be + combined and used in the order provided as a decorator. + For example:: + + @view_config(..., decorator=[decorator1, decorator2]) + def myview(request): + .... + + Is similar to doing:: + + @view_config(...) + @decorator2 + @decorator1 + def myview(request): + ... + + Except with the existing benefits of ``decorator=`` (having a common + decorator syntax for all view calling conventions and not having to + think about preserving function attributes such as ``__name__`` and + ``__module__`` within decorator logic). + mapper A Python object or :term:`dotted Python name` which refers to a -- cgit v1.2.3