From f4b5b973c23ac629c7dd6a093a69ebdbc206b42a Mon Sep 17 00:00:00 2001 From: Casey Duncan Date: Sat, 1 Jan 2011 13:08:37 -0700 Subject: XXX try to clearly explain how the view name is derived during traversal, confirm this is sufficiently truthy XXX --- docs/narr/traversal.rst | 9 +++++---- 1 file 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 -- cgit v1.2.3