Code review comment for lp:~spiv/bzr/hooks-refactoring

Revision history for this message
Martin Pool (mbp) wrote :

I don't personally care very much where the quotes are, but what I was
asking for, was, from pep 257

>> Multi-line docstrings consist of a summary line just like a one-line docstring, followed by a blank line, followed by a more elaborate description. The summary line may be used by automatic indexing tools; it is important that it fits on one line and is separated from the rest of the docstring by a blank line.

If you have eight characters of indent plus six characters of quotes
and a limit around 72-80 you do need to come up with a pretty terse
(down to 58 chars) summary sentence.

--
Martin

« Back to merge proposal