- Added API docs for the ``repoze.bfg.testing`` methods

  ``registerAdapter``, ``registerUtiity``, ``registerSubscriber``, and
  ``cleanUp``.

- Added glossary entry for "root factory".

2 files changed, 18 insertions, 0 deletions

diff --git a/docs/api/testing.rst b/docs/api/testing.rst
index 9aebc7d30..7870ed1d3 100644
--- a/docs/api/testing.rst
+++ b/docs/api/testing.rst
@@ -17,6 +17,14 @@
 
   .. autofunction:: registerViewPermission
 
+  .. autofunction:: registerUtility
+
+  .. autofunction:: registerAdapter
+
+  .. autofunction:: registerSubscriber
+
+  .. autofunction:: cleanUp
+
   .. autoclass:: DummyModel
      :members:
 
diff --git a/docs/glossary.rst b/docs/glossary.rst
index b55f8395c..6d4d83f51 100644
--- a/docs/glossary.rst
+++ b/docs/glossary.rst
@@ -338,3 +338,13 @@ Glossary
     itself, its parent, its parent's parent, and so on.  The order of
     the sequence is context-first, then the parent of the context,
     then its parent's parent, and so on.
+  Root Factory
+    The "root factory" of an :mod:`repoze.bfg` application is called
+    on every request sent to the application.  The root factory
+    returns the traversal root of an application.  It is
+    conventionally named ``get_root``.  An application must supply a
+    root factory to :mod:`repoze.bfg` within a call to
+    ``repoze.bfg.router.make_app``; however, an application's root
+    factory may be passed to ``make_app`` as ``None``, in which case
+    the application performs no graph traversal and uses :term:`URL
+    dispatch` for all URL-to-view code mappings.