View callable definition.

1 files changed, 11 insertions, 7 deletions

diff --git a/docs/glossary.rst b/docs/glossary.rst
index 51aba03b5..7e7a899a5 100644
--- a/docs/glossary.rst
+++ b/docs/glossary.rst
@@ -62,13 +62,17 @@ Glossary
     "view" directive's "view" attribute): the colon (``:``) is not
     used; in its place is a dot.
   View
-    A "view" is a callable which returns a response object.  It should
-    accept two values: :term:`context` and :term:`request`.  An
-    alternate calling convention allows a view to be defined as a a
-    callable which only accepts a single ``request`` argument.  A view
-    is the primary mechanism by which a developer writes user
-    interface code within :mod:`repoze.bfg`.  See :ref:`views_chapter`
-    for more information about :mod:`repoze.bfg` views.
+    Common vernacular for a :term:`view callable`.
+  View Callable
+    A "view callable" is a callable Python object which returns a
+    response object which is associated with a :term:`view
+    configuration`.  It should accept two values: :term:`context` and
+    :term:`request`.  An alternate calling convention allows a view to
+    be defined as a a callable which only accepts a single ``request``
+    argument.  A view callable is the primary mechanism by which a
+    developer writes user interface code within :mod:`repoze.bfg`.
+    See :ref:`views_chapter` for more information about
+    :mod:`repoze.bfg` view callables.
   View Configuration
     View configuration is the act of associating a view callable with
     configuration information.  This configuration information helps