[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 7
From: |
Po Lu |
Subject: |
Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72 |
Date: |
Sat, 03 Feb 2024 18:02:52 +0800 |
User-agent: |
Gnus/5.13 (Gnus v5.13) |
Eli Zaretskii <eliz@gnu.org> writes:
> Please excuse me for being blunt, but this is a tempest in a teapot.
> To see why, please collect the statistics of the line length of our
> doc strings: you will see that we already have a lot of them that
> exceed even the new value of 72. The reason is simple: it is very
> rare to fill doc strings using fill commands. I, for one, almost
> never do that, instead "filling" them by hand to make each line, and
> the doc string in general, read reasonably.
I only do so when the filling commands fail to produce properly
formatted messages, such as when a table or long symbols are present
which the filling commands wrap pedantically for being only 1 or two
characters past the fill column.
> So I think this setting should affect almost no one, and making a
> showcase out of this change just misses the entire point of the
> "December's debacle". We have more important stuff to discuss than
> this insignificant detail.
Before responding, I tried to measure the impact of this change by
running:
(mapatoms (lambda (atom)
(when (functionp atom)
(and (documentation atom)
(insert (documentation atom) "\n")))))
in a buffer, with the fill column set to 72, and typing C-x h M-q. Upon
restoring the fill column to 64 and enabling the fill column indicator,
the number of lines and words beyond it increased visibly. So this is
not so insignificant a detail.
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, (continued)
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Emanuel Berg, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Emanuel Berg, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Eric S Fraga, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Emanuel Berg, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Stefan Kangas, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Eli Zaretskii, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72,
Po Lu <=
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Alfred M. Szmidt, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Eli Zaretskii, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Emanuel Berg, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Stefan Kangas, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Po Lu, 2024/02/03
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Emanuel Berg, 2024/02/04
- Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Emanuel Berg, 2024/02/04
Re: master 72b1379f079: Increase `emacs-lisp-docstring-fill-column` to 72, Emanuel Berg, 2024/02/02