More docstring filling woes

[Georg Brandl]

(I selected "PEP-257-NN" as the docstring fill style.)
Given the following code:

class Test(object):
    """
    Builds target formats from the reST sources.
    """

    def method1(self):
        """Return the template bridge configured."""
        pass

    def method2(self):
        """Load necessary templates and perform initialization. The default implementation does nothing.
        """
        pass

After filling the three docstrings with fill-paragraph, it looks like this:

class Test(object):
    """ Builds target formats from the reST sources. """

    def method1(self):
        """Return the template bridge configured.""" pass

    def method2(self):
        """Load necessary templates and perform initialization. The default
        implementation does nothing. """ pass

There are three misbehaviors here:
* should have removed the whitespace at the beginning and end of the class docstring
* in method1, the "pass" should remain on its own line
* in method2, the closing triple-quote should get its own line, and the "pass" too

[Andreas Roehler (a-roehler)]

please try again

[Georg Brandl (gbrandl)]

Test file after filling, latest version:

-------------

class Test(object):
        """Builds target formats from the reST sources."""

    def method1(self):
                """Return the template bridge configured."""
        pass

    def method2(self):
                """Load necessary templates and perform initialization. The default implementation

        does nothing.
        """
        pass

-------------

There appears to be a bug with the amount of indentation inserted. Also in the last docstring the first paragraph should not be split by an empty line.

Oh, and after filling, point is placed after the closing quote. Calling fill-paragraph again I get "lisp nesting exceeds max-eval-depth".

[Ryan Olf (ryan-efrus)]

In the latest version from the git mirror, I am seeing similar problems with py-fill-paragraph, where it pretty much just mangles the docstring.