diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/narr/introduction.rst | 18 |
1 files changed, 13 insertions, 5 deletions
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 -------------------- |