Robert Brewer avatar Robert Brewer committed 4991fe0

Book: New blurb about the request and response object lifetimes.

Comments (0)

Files changed (2)

docs/book/xml/apireference.xml

     </section>
     <section id="cherrypyrequest">
         <title>cherrypy.request</title>
+        <para>The cherrypy.request object contains request-related objects. Pretty lame description,
+        but that's all it does; it's a big data dump. At the beginning of each HTTP request, the
+        existing request object is destroyed, and a new one is created, (one request object for each
+        thread). Therefore, CherryPy (and you yourself) can stick data into cherrypy.request and not
+        worry about it conflicting with other requests.</para>
         <section>
             <title>cherrypy.request.remoteAddr</title>
             <para>This attribute is a string containing the IP address of the client. It will be an
     <!-- end cherrypy.request section -->
     <section id="cherrypyresponse">
         <title>cherrypy.response</title>
+        <para>The cherrypy.response object contains response-related objects. Pretty lame
+        description, but that's all it does; it's a big data dump. At the beginning of each HTTP
+        request, the existing response object is destroyed, and a new one is created, (one response
+        object for each thread). Therefore, CherryPy (and you yourself) can stick data into
+        cherrypy.response and not worry about it conflicting with other requests.</para>
         <section>
             <title>cherrypy.response.headerMap</title>
             <para>This attribute is a dictionary with automatically titled keys (e.g.,

docs/book/xml/gettingstarted.xml

                 <arg choice="req">install</arg>
             </cmdsynopsis>
             <para>Alternately, since CherryPy has no dependencies, you don't have to run setup.py.
-            Simply checkout the code into a directory which is on your Python path, such as your
-            site-packages directory.
-            </para>
+            Instead, checkout <code>/trunk/cherrypy</code> into a directory which is on your Python
+            path, such as <code>site-packages/cherrypy</code>.</para>
         </section>
     </section>
     <section>
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.