From 6b2c15e8187b072343cb162d731b5026cc0f940a 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 b00c4b9f2..e8169e958 100644 --- a/pyramid/config/views.py +++ b/pyramid/config/views.py @@ -816,6 +816,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