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

bdarnell · bdarnell · commit e4feeba25d1f · 2013-03-16T10:34:34.000-04:00
Reformat the HTTPFile docs where were causing odd reference errors.
diff --git 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
@@ -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
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-SPHINXOPTS=-W -d build/doctrees .`
	`1`	`+SPHINXOPTS=-n -W -d build/doctrees .`
`2`	`2`
`3`	`3`	`.PHONY: sphinx`
`4`	`4`	`sphinx:`