Turn on dangling-reference warning in sphinx for local builds.

Reformat the HTTPFile docs where were causing odd reference errors.

diff --git a/docs/Makefile b/docs/Makefile
index 1b8b30debb1b18f5cebc773732f1922ca43301ba..97b258758dd9875f0186631ad115ddfd07302983 100644 (file)
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -1,4 +1,4 @@
-SPHINXOPTS=-W -d build/doctrees .
+SPHINXOPTS=-n -W -d build/doctrees .
 
 .PHONY: sphinx
 sphinx:

diff --git a/tornado/httputil.py b/tornado/httputil.py
index 3fd709b81ddab55a3f7bd14205ecbc18a9b43fe9..8a7c2139762a7571f2179e7f3007ee343455b2a5 100644 (file)
--- a/tornado/httputil.py
+++ b/tornado/httputil.py
@@ -216,10 +216,9 @@ class HTTPFile(ObjectDict):
     """Represents an HTTP file. For backwards compatibility, its instance
     attributes are also accessible as dictionary keys.
 
-    :ivar filename:
-    :ivar body:
-    :ivar content_type: The content_type comes from the provided HTTP header
-        and should not be trusted outright given that it can be easily forged.
+    * ``filename``
+    * ``body``
+    * ``content_type``
     """
     pass