summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCasey Duncan <casey.duncan@gmail.com>2011-01-01 13:08:37 -0700
committerCasey Duncan <casey.duncan@gmail.com>2011-01-01 13:08:37 -0700
commitf4b5b973c23ac629c7dd6a093a69ebdbc206b42a (patch)
treebd047295f7415756896674812865a9be353d310d
parent1dff47ead5b1beedab1b8cbbab4ad7a93fc4c5d7 (diff)
downloadpyramid-f4b5b973c23ac629c7dd6a093a69ebdbc206b42a.tar.gz
pyramid-f4b5b973c23ac629c7dd6a093a69ebdbc206b42a.tar.bz2
pyramid-f4b5b973c23ac629c7dd6a093a69ebdbc206b42a.zip
XXX try to clearly explain how the view name is derived during traversal, confirm this is sufficiently truthy XXX
-rw-r--r--docs/narr/traversal.rst9
1 files changed, 5 insertions, 4 deletions
diff --git a/docs/narr/traversal.rst b/docs/narr/traversal.rst
index 2b40c4d94..d5f61fa1b 100644
--- a/docs/narr/traversal.rst
+++ b/docs/narr/traversal.rst
@@ -74,10 +74,11 @@ successfully resolved. If any resource found during traversal lacks a
:exc:`KeyError`, traversal ends immediately, and that resource becomes
the :term:`context`.
-The results of a :term:`traversal` also include a :term:`view name`. The
-:term:`view name` is the *first* URL path segment in the set of ``PATH_INFO``
-segments "left over" in the path segment list popped by the traversal process
-*after* traversal finds a context resource.
+The results of a :term:`traversal` also include a :term:`view name`. If
+traversal ends before the path segment sequence is exhausted, the
+:term:`view name` is the *next* remaining path segment element. If the
+:term:`traversal` expends all of the path segments, then the :term:`view
+name` is the empty string (`''`).
The combination of the context resource and the :term:`view name` found
via traversal is used later in the same request by the :term:`view