From ab8048ab0ec363f552320280743323b1fd21ae3f Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Sat, 19 Jul 2008 22:13:15 +0000 Subject: --- docs/narr/introduction.rst | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) (limited to 'docs') diff --git a/docs/narr/introduction.rst b/docs/narr/introduction.rst index a2b925265..0782af2fb 100644 --- a/docs/narr/introduction.rst +++ b/docs/narr/introduction.rst @@ -371,11 +371,19 @@ that is willing to deal with that case", and returns a view. It is passed the "biz" object as the "context" and the current WebOb request as the "request". It returns a response. -The only "special case" is when you end up with a "view name" that is -the empty string. In this case the "default view" is looked up. The -default view has a name that equals the empty string. If a view is -configured in the view registry without a name, it is the default -view. +There are two special cases: + +- During traversal you will often end up with a "view name" that is + the empty string. This indicates that ``repoze.bfg`` should look up + the *default view*. The default view is a view that is registered + with no name or a view which is registered with a name that equals + the empty string. + +- If any path segment element begins with the special characters + ``@@`` (think of them as goggles), that element is considered the + view name immediately and traversal stops there. This allows you to + address views that may have the same names as model instance names + without conflict. A Sample Application -------------------- -- cgit v1.2.3