- Allow ``decorator`` and ``mapper`` arguments to view ZCML directive.

- Document ``decorator`` and ``mapper`` arguments in various places.

1 files changed, 14 insertions, 0 deletions

diff --git a/docs/zcml/view.rst b/docs/zcml/view.rst
index b4fabdc2c..ba5c7bf23 100644
--- a/docs/zcml/view.rst
+++ b/docs/zcml/view.rst
@@ -213,6 +213,20 @@ Predicate Attributes
   associated view callable will be considered viable for a given
   request.
 
+``decorator``
+  A :term:`dotted Python name` to a function that will be used to decorate
+  the registered :term:`view callable`.  The decorator function will be
+  called with the view callable as a single argument.  The view callable it
+  is passed will accept ``(context, request)``.  The decorator must return a
+  replacement view callable which also accepts ``(context, request)``.
+
+``mapper``
+  A :term:`dotted Python name` which refers to a :term:`view mapper`, or
+  ``None``.  By default it is ``None``, which indicates that the view should
+  use the default view mapper.  This plug-point is useful for Pyramid
+  extension developers, but it's not very useful for 'civilians' who are just
+  developing stock Pyramid applications.
+
 Examples
 ~~~~~~~~