summaryrefslogtreecommitdiff
path: root/docs/narr
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2013-10-02 18:57:17 -0400
committerChris McDonough <chrism@plope.com>2013-10-02 18:57:17 -0400
commit61d1f729f4d9cc17a5fbcff0612512bc9f5fe7a2 (patch)
tree66bb56b03f2df802dd0836d017a59f993bcf86c8 /docs/narr
parent79d9d6862ff906aa0bf26968e0ba763c54775b5c (diff)
parent96188ac4b74cb1e67cb95afdb9519ecd8934d688 (diff)
downloadpyramid-61d1f729f4d9cc17a5fbcff0612512bc9f5fe7a2.tar.gz
pyramid-61d1f729f4d9cc17a5fbcff0612512bc9f5fe7a2.tar.bz2
pyramid-61d1f729f4d9cc17a5fbcff0612512bc9f5fe7a2.zip
Merge branch 'bertjwregeer-docs/remove_redundant'
Diffstat (limited to 'docs/narr')
-rw-r--r--docs/narr/traversal.rst30
1 files changed, 5 insertions, 25 deletions
diff --git a/docs/narr/traversal.rst b/docs/narr/traversal.rst
index a60c5ba56..454bb5620 100644
--- a/docs/narr/traversal.rst
+++ b/docs/narr/traversal.rst
@@ -146,35 +146,15 @@ refer to a root factory defined in a different module.
If no :term:`root factory` is passed to the :app:`Pyramid`
:term:`Configurator` constructor, or if the ``root_factory`` value
-specified is ``None``, a *default* root factory is used. The default
+specified is ``None``, a :term:`default root factory` is used. The default
root factory always returns a resource that has no child resources; it
is effectively empty.
Usually a root factory for a traversal-based application will be more
-complicated than the above ``Root`` class; in particular it may be
-associated with a database connection or another persistence mechanism.
-
-.. sidebar:: Emulating the Default Root Factory
-
- For purposes of understanding the default root factory better, we'll note
- that you can emulate the default root factory by using this code as an
- explicit root factory in your application setup:
-
- .. code-block:: python
- :linenos:
-
- class Root(object):
- def __init__(self, request):
- pass
-
- config = Configurator(root_factory=Root)
-
- The default root factory is just a really stupid object that has no
- behavior or state. Using :term:`traversal` against an application that
- uses the resource tree supplied by the default root resource is not very
- interesting, because the default root resource has no children. Its
- availability is more useful when you're developing an application using
- :term:`URL dispatch`.
+complicated than the above ``Root`` class; in particular it may be associated
+with a database connection or another persistence mechanism. The above
+``Root`` class is analogous to the default root factory present in Pyramid. The
+default root factory is very simple and not very useful.
.. note::