More docs.

2 files changed, 32 insertions, 0 deletions

diff --git a/docs/narr/urldispatch.rst b/docs/narr/urldispatch.rst
index ad0388284..fbf3901be 100644
--- a/docs/narr/urldispatch.rst
+++ b/docs/narr/urldispatch.rst
@@ -163,6 +163,22 @@ accept
 
   .. note:: This feature is new as of :mod:`repoze.bfg` 1.1.
 
+custom_predicates
+
+  This value should be a sequence of references to custom predicate
+  callables.  Use custom predicates when no set of predefined
+  predicates does what you need.  Custom predicates can be combined
+  with predefined predicates as necessary.  Each custom predicate
+  callable should accept two arguments: ``context`` and ``request``
+  and should return either ``True`` or ``False`` after doing arbitrary
+  evaluation of the context and/or the request.  If all callables
+  return ``True``, the associated route will be considered viable for
+  a given request.  If any custom predicate returns ``False``, route
+  matching continues.  Note that the value ``context`` will always be
+  ``None`` when passed to a custom route predicate.
+
+  .. note:: This feature is new as of :mod:`repoze.bfg` 1.2.
+
 view_for
 
   The Python dotted-path name to a class or an interface that the
diff --git a/docs/narr/views.rst b/docs/narr/views.rst
index 01389cec0..678888872 100644
--- a/docs/narr/views.rst
+++ b/docs/narr/views.rst
@@ -555,6 +555,22 @@ path_info
 
   .. note:: This feature is new as of :mod:`repoze.bfg` 1.1.
 
+custom_predicates
+
+  This value should be a sequence of references to custom predicate
+  callables (e.g. ``dotted.name.one dotted.name.two``, if used in
+  ZCML; Python dotted names to callables separated by spaces).  Use
+  custom predicates when no set of predefined predicates do what you
+  need.  Custom predicates can be combined with predefined predicates
+  as necessary.  Each custom predicate callable should accept two
+  arguments: ``context`` and ``request`` and should return either
+  ``True`` or ``False`` after doing arbitrary evaluation of the
+  context and/or the request.  If all callables return ``True``, the
+  associated view callable will be considered viable for a given
+  request.
+
+  .. note:: This feature is new as of :mod:`repoze.bfg` 1.2.
+
 .. _mapping_views_to_urls_using_a_decorator_section:
 
 View Configuration Using the ``@bfg_view`` Decorator