diff --git a/docs/manual/src/docbook/appendix-namespace.xml b/docs/manual/src/docbook/appendix-namespace.xml
index d6aeb0a88d..53a5cbf81d 100644
--- a/docs/manual/src/docbook/appendix-namespace.xml
+++ b/docs/manual/src/docbook/appendix-namespace.xml
@@ -488,6 +488,13 @@
maintained by Spring Security. Full details can be found in the namespace
chapter.
+
+ The request-cache Element
+ Sets the RequestCache instance which will be used
+ by the ExceptionTranslationFilter to store request information
+ before invoking an AuthenticationEntryPoint.
+
+ Authentication Services
diff --git a/docs/manual/src/docbook/core-filters.xml b/docs/manual/src/docbook/core-filters.xml
index 9c0fae5828..1523f77cf8 100644
--- a/docs/manual/src/docbook/core-filters.xml
+++ b/docs/manual/src/docbook/core-filters.xml
@@ -168,6 +168,30 @@
to configure your application. See the
namespace appendix for more details.
+
+ SavedRequests and the RequestCache Interface
+ Another of ExceptionTranslationFilter's responsibilities is
+ to save the current request before invoking the AuthenticationEntryPoint.
+ This allows the request to be restored after the use has authenticated (see previous overview
+ of web authentication).
+ A typical example would be where the user logs in with a from, and is then redirected to the
+ original URL by the default SavedRequestAwareAuthenticationSuccessHandler
+ (see below).
+
+ The RequestCache encapsulates the functionality required for storing
+ and retrieving HttpServletRequest instances. By default
+ the HttpSessionRequestCache is used, which stores the request
+ in the HttpSession. The RequestCacheFilter
+ has the job of actually restoring the saved request from the cache when the user is redirected to
+ the original URL.
+
+ Under normal circumstances, you shouldn't need to modify any of this functionality, but the
+ saved-request handling is a best-effort approach and there may be situations which
+ the default configuration isn't able to handle. The use of these interfaces makes it fully pluggable
+ from Spring Security 3.0 onwards.
+
+
+
SecurityContextPersistenceFilter