[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#29003: 25.3; Docstring from PEP 257 is filled incorrectly by Emacs
From: |
Stefan Kangas |
Subject: |
bug#29003: 25.3; Docstring from PEP 257 is filled incorrectly by Emacs |
Date: |
Mon, 11 Nov 2019 03:43:49 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) |
Radon Rosborough <radon.neon@gmail.com> writes:
>> I think all Emacs fill commands will fill this as one continous
>> line,
>
> As it currently stands, yes. That doesn't have to be the case,
> however. For example, package `python-docstring' can understand reST
> syntax, so that:
>
> def example_function():
> """Initialize engine.
>
> :param holes: Number of holes.
> :param rounds: Number of rounds.
> :param colors: Number of colors.
>
> :returns: Game engine instance.
> """
> pass
>
> is not modified when filled. The question is whether the example given
> by PEP 257 should be considered "standard" syntax for introducing
> keyword arguments, and whether such syntax should be supported by
> Emacs in a similar way to how `python-docstring' supports reST syntax.
I think this should ideally be supported by Emacs, but it should be
configurable and disabled by default.
Best regards,
Stefan Kangas
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- bug#29003: 25.3; Docstring from PEP 257 is filled incorrectly by Emacs,
Stefan Kangas <=