Я набираю строку документации Python все в одну строку, как это:
"""
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.
"""
а затем я нажимаю Mq ( fill-paragraph
), и я получаю это:
"""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.
"""
У меня есть две проблемы с этим:
- Строка документа начинается с той же строки, что и
"""
- я бы предпочел, чтобы тройная кавычка оставалась на отдельной строке. - (Гораздо ниже приоритет.) Строка документации заканчивается пустой строкой.
Приведенный выше пример надуманный, но я часто сталкиваюсь с этим, особенно когда редактирую существующие строки документов, где я хотел бы просто M-q
перефразировать весь пункт.
источник
paragraph-separate
. Стиль строки документаpython.el
настраивается.pep-257-nn
вpython-fill-docstring-style
.