Doc tweaks

--HG--
branch : trunk

pylons/docs/en/forms.rst

@@ -193,6 +193,7 @@ Our form actually has two fields, an email text field and a submit button. If ex
 Pylons comes with an easy to use `validate` decorator, if you wish to use it import it in your `lib/base.py` like this:
 
 .. code-block:: python
+
     # other imports
 
     from pylons.decorators import validate

pylons/docs/en/gettingstarted.rst

@@ -199,9 +199,8 @@ The default controller will return just the string 'Hello World':
 
     import logging
 
-    from pylons import request, response, session
-    from pylons import tmpl_context as c
-    from pylons.controllers.util import abort, redirect_to, url_for
+    from pylons import request, response, session, tmpl_context as c
+    from pylons.controllers.util import abort, redirect_to
 
     from helloworld.lib.base import BaseController, render
     # import helloworld.model as model

pylons/docs/en/logging.rst

@@ -18,7 +18,8 @@ For example, in the helloworld project's hello controller
 
     import logging 
 
-    from helloworld.lib.base import * 
+    from pylons import request, response, session, tmpl_context as c
+    from pylons.controllers.util import abort, redirect_to
 
     log = logging.getLogger(__name__) 
 
@@ -36,7 +37,8 @@ To log messages, simply use methods available on that Logger object:
 
     import logging 
 
-    from helloworld.lib.base import * 
+    from pylons import request, response, session, tmpl_context as c
+    from pylons.controllers.util import abort, redirect_to
 
     log = logging.getLogger(__name__) 
 

pylons/docs/en/testing.rst

@@ -268,9 +268,14 @@ Example:
             assert response.email.name == 'Fred Smith' 
 
 
-.. see_also::
+.. seealso::
+
     `WebTest Documentation <http://pythonpaste.org/webtest/>`_
+        Documentation covering webtest and its usage
+
     :mod:`WebTest Module docs <webtest>`
+        Module API reference for methods available for use when testing
+        the application
 
 .. _unit_testing:
 

pylons/docs/en/thirdparty/routes.rst

@@ -18,4 +18,5 @@
 .. automodule:: routes.util
 
 .. autofunction:: url_for
+.. autoclass:: URLGenerator
 .. autofunction:: redirect_to

pylons/docs/en/views.rst

@@ -68,9 +68,8 @@ To pass objects to templates, the standard Pylons method is to attach them to th
 
     import logging
 
-    from pylons import request, response, session
-    from pylons import tmpl_context as c
-    from pylons.controllers.util import abort, redirect_to, url_for
+    from pylons import request, response, session, tmpl_context as c
+    from pylons.controllers.util import abort, redirect_to
 
     from helloworld.lib.base import BaseController, render
     # import helloworld.model as model

pylons/templating.py

@@ -75,7 +75,7 @@ def index(self):
   object for this request
 - :class:`session` -- Pylons session object (unless Sessions are
   removed)
-- :method:`~routes.util.URLGenerator.url` -- Routes url generator
+- :class:`url <routes.util.URLGenerator>` -- Routes url generator
   object
 - :class:`translator` -- Gettext translator object configured for
   current locale