summaryrefslogtreecommitdiff
path: root/docs/narr/urlmapping.rst
diff options
context:
space:
mode:
authorChris McDonough <chrism@agendaless.com>2010-01-16 07:55:45 +0000
committerChris McDonough <chrism@agendaless.com>2010-01-16 07:55:45 +0000
commitc44a950c296f3af9018da603a2a1900bbd381af5 (patch)
treee96bf98e46c85935c8d047961f77e51d1c0e87f7 /docs/narr/urlmapping.rst
parent590fe7c48d15f6280955e9784a9f42c2e28bca69 (diff)
downloadpyramid-c44a950c296f3af9018da603a2a1900bbd381af5.tar.gz
pyramid-c44a950c296f3af9018da603a2a1900bbd381af5.tar.bz2
pyramid-c44a950c296f3af9018da603a2a1900bbd381af5.zip
Stray text.
Diffstat (limited to 'docs/narr/urlmapping.rst')
-rw-r--r--docs/narr/urlmapping.rst23
1 files changed, 11 insertions, 12 deletions
diff --git a/docs/narr/urlmapping.rst b/docs/narr/urlmapping.rst
index b7ba7021b..da8d6ab9f 100644
--- a/docs/narr/urlmapping.rst
+++ b/docs/narr/urlmapping.rst
@@ -36,18 +36,17 @@ application developer, and invokes it. A view callable returns a
.. sidebar:: What Good is A Context Finding Subsystem?
- Many other web frameworks such as :term:`Pylons` or :term:`Django`
+ The :term:`URL dispatch` mode of :mod:`repoze.bfg` as well as many
+ other web frameworks such as :term:`Pylons` or :term:`Django`
actually collapse the two steps of context finding and view lookup
- into a single step. In such systems, a URL maps *directly* to a
- view callable. These systems possess no analogue to a
- context finding subsystem: they are "context-free". This makes
- them simpler to understand than systems which use "context".
- However, using an explicit context finding step provides extra
- flexibility. For example, it makes it possible to protect your
- application with declarative context-sensitive instance-level
- :term:`authorization`, which is not well supported in frameworks
- that do not provide a notion of a context. See the
- :ref:`security_chapter` for more information.
+ into a single step. In these systems, a URL can map *directly* to
+ a view callable. This makes them simpler to understand than
+ systems which use distinct subsystems to locate a context and find
+ a view. However, explicitly using context finding step provides
+ extra flexibility. For example, it makes it possible to protect
+ your application with declarative context-sensitive instance-level
+ :term:`authorization`, which is not well-supported in frameworks
+ that do not provide a notion of a context.
There are two separate context finding subsystems in
:mod:`repoze.bfg`: :term:`traversal` and :term:`URL dispatch`. The
@@ -55,7 +54,7 @@ subsystems are documented within this chapter. They can be used
separately or they can be combined.
There is only one view lookup subsystem present in :mod:`repoze.bfg`.
-It is not documented in this chapter. Instead, it is documented
+It is not documented within this chapter. Instead, it is documented
within :ref:`views_chapter`.
.. toctree::