Doc cleanups.

* Fix doc generation for httpclient.py (unescaped \r\n)
* Manually specify signature of Template constructor
* Include IOLoop.time

Closes #644.

tornado/httpclient.py

@@ -221,7 +221,7 @@ class HTTPRequest(object):
                  validate_cert=None, ca_certs=None,
                  allow_ipv6=None,
                  client_key=None, client_cert=None):
-        """Creates an `HTTPRequest`.
+        r"""Creates an `HTTPRequest`.
 
         All parameters except `url` are optional.
 

tornado/template.py

@@ -203,6 +203,9 @@ class Template(object):
     We compile into Python from the given template_string. You can generate
     the template from variables with generate().
     """
+    # note that the constructor's signature is not extracted with
+    # autodoc because _UNSET looks like garbage.  When changing
+    # this signature update website/sphinx/template.rst too.
     def __init__(self, template_string, name="<string>", loader=None,
                  compress_whitespace=None, autoescape=_UNSET):
         self.name = name

website/sphinx/conf.py

@@ -30,6 +30,9 @@ coverage_ignore_classes = [
     "Runner",
     "YieldPoint",
 
+    # tornado.ioloop
+    "PollIOLoop",
+
     # tornado.web
     "ChunkedTransferEncoding",
     "GZipContentEncoding",

website/sphinx/ioloop.rst

@@ -25,14 +25,15 @@
    .. automethod:: IOLoop.update_handler
    .. automethod:: IOLoop.remove_handler
 
-   Timeouts
-   ^^^^^^^^
+   Callbacks and timeouts
+   ^^^^^^^^^^^^^^^^^^^^^^
 
    .. automethod:: IOLoop.add_callback
    .. automethod:: IOLoop.add_callback_from_signal
    .. automethod:: IOLoop.add_future
    .. automethod:: IOLoop.add_timeout
    .. automethod:: IOLoop.remove_timeout
+   .. automethod:: IOLoop.time
    .. autoclass:: PeriodicCallback
       :members:
 

website/sphinx/template.rst

@@ -6,7 +6,7 @@
    Class reference
    ---------------
 
-   .. autoclass:: Template
+   .. autoclass:: Template(template_string, name="<string>", loader=None, compress_whitespace=None, autoescape="xhtml_escape")
       :members:
 
    .. autoclass:: BaseLoader