Ich schreibe einen Python-Docstring in einer Zeile:
"""
This is a long docstring. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec a diam lectus. Sed sit amet ipsum mauris. Maecenas congue ligula ac quam viverra nec consectetur ante hendrerit. Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean ut gravida lorem. Ut turpis felis, pulvinar a semper sed, adipiscing id dolor. Pellentesque auctor nisi id magna consequat sagittis.
"""
und dann drücke ich Mq ( fill-paragraph
) und bekomme folgendes:
"""This is a long docstring. Lorem ipsum dolor sit amet, consectetur
adipiscing elit. Donec a diam lectus. Sed sit amet ipsum
mauris. Maecenas congue ligula ac quam viverra nec consectetur ante
hendrerit. Donec et mollis dolor. Praesent et diam eget libero egestas
mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem
lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non
tortor. Lorem ipsum dolor sit amet, consectetur adipiscing
elit. Aenean ut gravida lorem. Ut turpis felis, pulvinar a semper sed,
adipiscing id dolor. Pellentesque auctor nisi id magna consequat
sagittis.
"""
Ich habe zwei Probleme damit:
- Der Docstring beginnt in derselben Zeile wie der
"""
- ich würde es vorziehen, wenn das dreifache Anführungszeichen in einer eigenen Zeile bleibt. - (Viel niedrigere Priorität.) Die Dokumentzeichenfolge endet mit einer Leerzeile.
Das obige Beispiel ist erfunden, aber ich stoße häufig darauf, besonders wenn ich vorhandene Dokumentstrings bearbeite, bei denen ich einfach M-q
den gesamten Para neu fließen lassen möchte.
paragraph-separate
. Der Docstring-Stil vonpython.el
ist anpassbar.