how to access per-app settings

1 files changed, 23 insertions, 0 deletions

diff --git a/sphinx/source/basics.rst b/sphinx/source/basics.rst
index 7cdcbf85..e559b803 100644
--- a/sphinx/source/basics.rst
+++ b/sphinx/source/basics.rst
@@ -321,6 +321,29 @@ A variant notation to the above:
 Both methods have the same effect so pick the one
 that suits your style best.
 
+You can add settings that are not specific to a request URL
+and retrieve it from your page handler as follow:
+
+.. code-block:: ini
+		
+   [/]
+   tools.gzip.on: True
+
+   [googleapi]
+   key = "..."
+   appid = "..."
+   
+.. code-block:: python
+
+   class Root(object):
+       @cherrypy.expose
+       def index(self):
+           google_appid = cherrypy.request.app.config['googleapi']['appid']
+           return "hello world!"
+
+   cherrypy.quickstart(Root(), '/', "app.conf")
+
+
 Cookies
 #######