Fix doc warnings and errors. Includes a import fix to handle py2. (#1030

)

* Fix doc warnings and errors. Includes a import fix to handle py2.

* Really fix one last doc warning.

* Backout the change to iter(iterator).next. In some light testing with Python 3.5.2 I could not trigger any errors using LintMiddleware so the code may be suitable for 2 and 3.

docs/conf.py

@@ -210,5 +210,5 @@
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
     'http://docs.python.org/dev': None,
-    'http://www.sqlalchemy.org/docs/05': None
+    'http://docs.sqlalchemy.org/en/latest/': None
 }

docs/contrib/lint.rst

@@ -2,6 +2,8 @@
 Lint Validation Middleware
 ==========================
 
+.. currentmodule:: werkzeug.contrib.lint
+
 .. automodule:: werkzeug.contrib.lint
 
 .. autoclass:: LintMiddleware

docs/debug.rst

@@ -81,8 +81,9 @@ Pasting Errors
 ==============
 
 If you click on the `Traceback` title, the traceback switches over to a text
-based one.  The text based one can be pasted to `gist.github.com`_ with one
+based one.  The text based one can be pasted to `gist.github.com <https://gist.github.com>`_ with one
 click.
 
 
-.. _paste.pocoo.org: https://gist.github.com/
+.. _paste.pocoo.org: https://gist.github.com
+

werkzeug/contrib/lint.py

@@ -19,7 +19,11 @@
     :copyright: (c) 2014 by the Werkzeug Team, see AUTHORS for more details.
     :license: BSD, see LICENSE for more details.
 """
-from urlparse import urlparse
+try:
+    from urllib.parse import urlparse
+except ImportError:
+    from urlparse import urlparse
+
 from warnings import warn
 
 from werkzeug.datastructures import Headers

werkzeug/wsgi.py

@@ -902,6 +902,9 @@ def make_line_iter(stream, limit=None, buffer_size=10 * 1024,
     .. versionadded:: 0.9
        added support for iterators as input stream.
 
+    .. versionadded:: 0.11.10
+       added support for the `cap_at_buffer` parameter.
+
     :param stream: the stream or iterate to iterate over.
     :param limit: the limit in bytes for the stream.  (Usually
                   content length.  Not necessary if the `stream`
@@ -911,8 +914,6 @@ def make_line_iter(stream, limit=None, buffer_size=10 * 1024,
                           than the buffer size.  Internally this is implemented
                           that the buffer size might be exhausted by a factor
                           of two however.
-    .. versionadded:: 0.11.10
-       added support for the `cap_at_buffer` parameter.
     """
     _iter = _make_chunk_iter(stream, limit, buffer_size)