Added explanations to docstring.

rforkel

2012-06-26 9aac76aad6d8e40278f0aab16322bd1dbe6803bc

Added explanations to docstring.

 pyramid/config/views.py

@@ -846,6 +846,27 @@
          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