summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorCasey Duncan <casey.duncan@gmail.com>2010-11-24 23:39:59 -0700
committerCasey Duncan <casey.duncan@gmail.com>2010-11-24 23:39:59 -0700
commit07ee3a582cfeeab1406a31ee28a99d320f40219b (patch)
tree861da00fac812e9b9737a988f55ed4d1f7752f26 /docs
parent2d5bc365509262831652753d21e797f377eb7811 (diff)
downloadpyramid-07ee3a582cfeeab1406a31ee28a99d320f40219b.tar.gz
pyramid-07ee3a582cfeeab1406a31ee28a99d320f40219b.tar.bz2
pyramid-07ee3a582cfeeab1406a31ee28a99d320f40219b.zip
Clarify paragraph explaining use_global_views
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/hybrid.rst17
1 files changed, 9 insertions, 8 deletions
diff --git a/docs/narr/hybrid.rst b/docs/narr/hybrid.rst
index b43ace4da..6a92d2d46 100644
--- a/docs/narr/hybrid.rst
+++ b/docs/narr/hybrid.rst
@@ -406,14 +406,15 @@ with this route).
Making Global Views Match
+++++++++++++++++++++++++
-By default, view configurations that don't mention a ``route_name`` will be
-not found by view lookup when a route that mentions a ``*traverse`` in its
-pattern matches. You can make these match forcibly by adding the
-``use_global_views`` flag to the route definition. For example, the
-``myproject.views.bazbuz`` view below will be found if the route named
-``abc`` below is matched and the ``PATH_INFO`` is ``/abc/bazbuz``, even
-though the view configuration statement does not have the
-``route_name="abc"`` attribute.
+By default, only view configurations that mention a ``route_name``
+will be found during view lookup when a route that has a ``*traverse``
+in its pattern matches. You can allow views without a ``route_name``
+attribute to match a route by adding the ``use_global_views`` flag to
+the route definition. For example, the ``myproject.views.bazbuz``
+view below will be found if the route named ``abc`` below is matched
+and the ``PATH_INFO`` is ``/abc/bazbuz``, even though the view
+configuration statement does not have the ``route_name="abc"``
+attribute.
.. code-block:: python
:linenos: