diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/api/exceptions.rst | 11 | ||||
| -rw-r--r-- | docs/index.rst | 1 | ||||
| -rw-r--r-- | docs/narr/views.rst | 4 |
3 files changed, 14 insertions, 2 deletions
diff --git a/docs/api/exceptions.rst b/docs/api/exceptions.rst new file mode 100644 index 000000000..63a3916ae --- /dev/null +++ b/docs/api/exceptions.rst @@ -0,0 +1,11 @@ +.. _exceptions_module: + +:mod:`repoze.bfg.exceptions` +---------------------------- + +.. automodule:: repoze.bfg.exceptions + + .. autoclass:: NotFound + + .. autoclass:: Forbidden + diff --git a/docs/index.rst b/docs/index.rst index 6b85f1440..1305104c4 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -57,6 +57,7 @@ Per-module :mod:`repoze.bfg` API documentation. api/chameleon_text api/chameleon_zpt api/events + api/exceptions api/location api/paster api/router diff --git a/docs/narr/views.rst b/docs/narr/views.rst index 5fe66dc63..b45221e71 100644 --- a/docs/narr/views.rst +++ b/docs/narr/views.rst @@ -680,7 +680,7 @@ The value of the ``permission`` attribute represents the permission that must be possessed by the user to invoke any found view. When a view is found that matches all predicates, but the invoking user does not possess the permission implied by any associated ``permission`` in -the current context, processing stops, and an ``Unauthorized`` error +the current context, processing stops, and an ``Forbidden`` error is raised, usually resulting in a "forbidden" view being shown to the invoking user. No further view narrowing or view lookup is done. @@ -989,7 +989,7 @@ user does not possess the ``add`` permission relative to the current .. note:: Packages such as :term:`repoze.who` are capable of intercepting an - ``Unauthorized`` response and displaying a form that asks a user to + ``Forbidden`` response and displaying a form that asks a user to authenticate. Use this kind of package to ask the user for authentication credentials. |