Jak ograniczyć pierwszy wiersz w doctrings Pythona do maksymalnej długości wiersza podczas wypełniania akapitu w Emacs?

Question

Moja instalacja to Emacs 24.4.1, Linux, kod źródłowy Pythona otwarty w buforze, tryb Pythona 0.24.4 (dostarczany z Emacsem), kolumna wypełnienia ustawiony na 70, styl python-fill-docstring ustawiony na zero. Nazywam fill-paragraph (M-q) z wewnątrz metody docstring metody klasy, aby ponownie sformatować docstring tak, że żadna linia nie będzie dłuższa niż 70 znaków. Ale pierwsza linia docstrukcji jest zawsze dłuższa. Wygląda na to, że wcięcie (8 spacji) nie jest uwzględniane w obliczaniu długości linii. Co mogę zrobić, aby ograniczyć długość linii do 70? Czy powinienem zamiast tego używać python-mode.el?

przykład:

class MyClass(object): 
    def my_method(self): 
     """Some long line with more than 70 characters in the docstring. Some more text.""" 

po m-Q, w docstring wygląda następująco. Pierwsza linia metoda docstring kończy się w kolumnie 78 (i druga linia nie jest wcięty, ale to inna kwestia):

class MyClass(object): 
    def my_method(self): 
     """Some long line with more than 70 characters in the docstring. Some 
more text.""" 

Ale o długości linii 70 powinno być tak:

class MyClass(object): 
    def my_method(self): 
     """Some long line with more than 70 characters in the 
     docstring. Some more text.""" 

Answer 1

Wraz z obecnym pnia python-mode.el, r1993 i stylu domyślnego pep-257-nn to Mq plony

class MyClass(object): 
    def my_method(self): 
     """Some long line with more than 70 characters in the docstring. 

     Some more text. 
     """ 

Answer 2

Moja odpowiedź consi sts z dwóch części:

1. Jest to błąd w python.el dostarczany z Emacsem. Zobacz bilety GNU #20860 i #21254. Rozwiązaniem jest ręczne sformatowanie instrukcji.
2. Pierwsza linia powinna być pojedynczym zdaniem, które nie jest dłuższe niż maksymalna długość linii, a następnie pustą linią. Wszystkie implementowane style docstrukcji (django, onetwo, pep-257, pep-257-nn, symmetric) są zgodne z tą zasadą. Pierwsze zdanie nie musi być opakowane w tym przypadku, a pierwsza linia nie może być zbyt długa z definicji.