Changes between Version 15 and Version 16 of RequestHandlers

Timestamp:

09/17/08 22:07:26 (2 years ago)

Author:

cmlenz

Comment:

Some typo fixes and clarifications

RequestHandlers

@@ -1 +1 @@
 = Request Handlers =
 
-A request handler is a neutral name for what some other frameworks call “controllers” or “views”. It is simply a Python function that accepts the request and response objects as parameters, and returns a response.
+A request handler is a neutral name for what some other frameworks call “controllers” or “views”. It is simply a Python function that accepts the request and response objects as parameters, and processes the request to generate a response in one way or another.
 
 {{{
@@ -58 +58 @@
 }}}
 
-If you do want to render a template, use the `render()` function to return a Genshi stream from the request handler. You pass any template data into the `render()` function as keyword arguments, and it will generate an output stream from the template based on the template data. The `render()` function also lets you override the template filename specified using the `@output` decorator: simple pass the template name as the first (and only) positional argument into `render()`.
+If you do want to render a template, use the `render()` function to return a Genshi stream from the request handler. You pass any template data into the `render()` function as keyword arguments, and it will generate an output stream from the template based on the template data. The `render()` function also lets you override the template filename specified using the `@output` decorator: simply pass the template name as the first (and only) positional argument into `render()`.
 
 === Default Template Data ===
@@ -77 +77 @@
  `ngettext()`:: Function for translating a message including plural forms
  `path_to()`:: Function for generating URLs based on the [UrlRouting routing configuration]
- `request`:: The `Request` object
- `response`:: The `Response` object
- `separated()`:: Helper function that adds separator strings to a list of strings
+ `request`:: The `Request` object (as provided by the `webob` package)
+ `response`:: The `Response` object (as provided by the `webob` package)
+ `separated()`:: Helper function that converts a list of strings into a single string with added separators
  `time`:: Python `time` class from the `datetime` module
  `timedelta`:: Python `timedelta` class from the `datetime` module
- `truncate()`:: Helper function that truncates a string to a specified limit of characters
+ `truncate()`:: Helper function that truncates a string to a specified limit of characters, taking word boundaries into account
  `XML()`:: Function to parse a string as XML and return a markup stream