summaryrefslogtreecommitdiff
path: root/docs/narr
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2012-10-27 19:45:51 -0400
committerChris McDonough <chrism@plope.com>2012-10-27 19:45:51 -0400
commit220435320613530bde80dd1c4a38a3e719f4af5d (patch)
tree7d1b5b1b367b6fc4b5d16cb88e3f8976acf6ece5 /docs/narr
parent0a1fb171514f4a41cf8679ef61c06397854dde07 (diff)
parent4a6cca62ddf33580b1de210ef5ca54bfb2769243 (diff)
downloadpyramid-220435320613530bde80dd1c4a38a3e719f4af5d.tar.gz
pyramid-220435320613530bde80dd1c4a38a3e719f4af5d.tar.bz2
pyramid-220435320613530bde80dd1c4a38a3e719f4af5d.zip
Merge branch 'master' into 1.4-branch
Diffstat (limited to 'docs/narr')
-rw-r--r--docs/narr/viewconfig.rst14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/narr/viewconfig.rst b/docs/narr/viewconfig.rst
index 3c7897969..752e6ad72 100644
--- a/docs/narr/viewconfig.rst
+++ b/docs/narr/viewconfig.rst
@@ -417,6 +417,20 @@ configured view.
.. versionadded:: 1.4a2
+``physical_path``
+ If specified, this value should be a string or a tuple representing the
+ :term:`physical path` of the context found via traversal for this predicate
+ to match as true. For example: ``physical_path='/'`` or
+ ``physical_path='/a/b/c'`` or ``physical_path=('', 'a', 'b', 'c')``. This is
+ not a path prefix match or a regex, it's a whole-path match. It's useful
+ when you want to always potentially show a view when some object is traversed
+ to, but you can't be sure about what kind of object it will be, so you can't
+ use the ``context`` predicate. The individual path elements inbetween slash
+ characters or in tuple elements should be the Unicode representation of the
+ name of the resource and should not be encoded in any way.
+
+ .. versionadded:: 1.4a3
+
``custom_predicates``
If ``custom_predicates`` is specified, it must be a sequence of references
to custom predicate callables. Use custom predicates when no set of