Je tape une docstring python sur une seule ligne comme ceci:
"""
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.
"""
puis je frappe Mq ( fill-paragraph
), et j'obtiens ceci:
"""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.
"""
J'ai deux problèmes avec ceci:
- Le docstring commence sur la même ligne que le
"""
- Je préfère que la citation triple reste sur sa propre ligne. - (Priorité beaucoup plus faible.) La docstring se termine par une ligne vierge.
L'exemple ci-dessus est artificiel, mais je rencontre cela fréquemment, en particulier lors de l'édition de docstrings existants où j'aimerais simplement M-q
et faire refluer l'ensemble du para.
la source
paragraph-separate
. Le style docstring depython.el
est personnalisable.pep-257-nn
danspython-fill-docstring-style
.