docstrings: fix "Sphinx param with type" pattern (#807)

* docstrings: fix "Sphinx param with type" pattern

Previously, the pattern only matched if the parameter description
followed on the same line, like so:

    :param type foo: A param named foo.

However, it's also valid for the parameter description to be wrapped
onto the next line, like so:

    :param type foo:
        A param named foo.

This change updates the pattern to match the second example as well, and
adds a test to verify this behaviour.

Fixes #806.

* Add Simon Ruggier to the AUTHORS file
This commit is contained in:
Simon Ruggier
2017-04-27 14:05:48 -04:00
committed by Dave Halter
parent e8718c6ce5
commit 338ea42ed9
3 changed files with 13 additions and 1 deletions

View File

@@ -49,6 +49,17 @@ def sphinxy2(a, b, x):
#?
sphinxy2()
def sphinxy_param_type_wrapped(a):
"""
:param str a:
Some description wrapped onto the next line with no space after the
colon.
"""
#? str()
a
# local classes -> github #370
class ProgramNode():
pass