doctests incorrectly formatted with reST option

[dmwelch]

def meaning(subject, answer=False):
    """
    >>> meaning('life', answer=True)
    42
    """

converts to

def meaning(subject, answer=False):
    """>>> meaning('life', answer=True)
    42

    :params subject: 
    ...
    """

which breaks the doctest.

In addition, the reST markup is placed after the doctests, which isn't optimal for Sphinx-generated HTML.

[dadadel]

Hi @dmwelch! Thanks for reporting your problem.

Pyment actually will proceed the docstring in the order of elements when it cannot identify them. As it suppose to have at first a description the doctest is considered as that.
I have to identify doctests to put them at the end of the generated docstring so the reST markups will be put before.

[dadadel]

@dmwelch This commit should fix the problem. So the Doctests will systematically be put to the end of the docstring. I think there could still be a problem if some text is between two doctests. The doctests will be extracted but not the indeopendent text that will stay on place.