[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: master ec464789df: Put the define-minor-mode boilerplate at the end
From: |
Lars Ingebrigtsen |
Subject: |
Re: master ec464789df: Put the define-minor-mode boilerplate at the end of the doc strings |
Date: |
Sun, 03 Apr 2022 13:59:51 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) |
Stefan Monnier <monnier@iro.umontreal.ca> writes:
> Why do we go through so much trouble? AFAICT all this does is force the
> doc to be "one line, one empty line and then the rest", which we don't
> enforce anywhere else (and is not always ideal, e.g. with some
> docstrings where the second line continues the first).
>
> Also, I don't see a strong reason to override the author's
> decision to put N≠1 empty lines after the first.
The original code did something slightly similar (with an empty line
after the first line). The loopy stuff is just because it's more
obviously correct than a `when'.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no