diff options
| author | Casey Duncan <casey.duncan@gmail.com> | 2010-11-24 23:11:03 -0700 |
|---|---|---|
| committer | Casey Duncan <casey.duncan@gmail.com> | 2010-11-24 23:11:03 -0700 |
| commit | d3569c8d7c2367a5e81d2425adf5e0b2841efed5 (patch) | |
| tree | 037dd7f71e9e28d01e32129e572b0c1777bf047b /docs/narr/hybrid.rst | |
| parent | d062f5d44ffc503cda7675389c58727d2b440f40 (diff) | |
| download | pyramid-d3569c8d7c2367a5e81d2425adf5e0b2841efed5.tar.gz pyramid-d3569c8d7c2367a5e81d2425adf5e0b2841efed5.tar.bz2 pyramid-d3569c8d7c2367a5e81d2425adf5e0b2841efed5.zip | |
Clarify paragraph describing why Traversable is traversable
Diffstat (limited to 'docs/narr/hybrid.rst')
| -rw-r--r-- | docs/narr/hybrid.rst | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/docs/narr/hybrid.rst b/docs/narr/hybrid.rst index a428ddc92..b90577a55 100644 --- a/docs/narr/hybrid.rst +++ b/docs/narr/hybrid.rst @@ -250,14 +250,14 @@ route configuration statement: config.add_route('home', '{foo}/{bar}/*traverse', factory='mypackage.routes.root_factory') -The ``factory`` above points at the function we've defined. It -will return an instance of the ``Traversable`` class as a root object -whenever this route is matched. Because the ``Traversable`` object -we've defined has a ``__getitem__`` method that does something -nominally useful, and because traversal uses ``__getitem__`` to walk -the nodes that make up an object graph, using traversal against the -root object implied by our route statement becomes a reasonable thing -to do. +The ``factory`` above points at the function we've defined. It will +return an instance of the ``Traversable`` class as a root object +whenever this route is matched. Instances of the``Traversable`` class +can be used for graph traversal because they have a ``__getitem__`` +method that does something nominally useful. Since traversal uses +``__getitem__`` to walk the nodes of an object graph, using traversal +against the root object implied by our route statement is a reasonable +thing to do. .. note:: |
