emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: [External] : Re: master 556c304007 2/2: * .dir-locals.el: Set emacs-


From: Drew Adams
Subject: RE: [External] : Re: master 556c304007 2/2: * .dir-locals.el: Set emacs-lisp-docstring-fill-column.
Date: Sat, 9 Jul 2022 20:14:06 +0000

> > It's SO EASY for a user to customize this, and SO
> > EASY to set it on the fly (`C-x f').
> 
> We seem to be miscommunicating.  I am discussing the default width of
> docstrings in Emacs itself (and indeed in Emacs Lisp generally), which
> is not something that users can customize.

I thought you were talking about both (separately).

Anyway, my comments are about both: Please don't
change the existing default for `fill-column',
and please don't change the existing convention
for doc-string line lengths or the default for
`emacs-lisp-docstring-fill-column'.

The existence of wider monitors is a red herring
- not a good reason to change those.

> I would love it if ELisp docstrings were written in a
> format that allowed us to re-fill them on the fly, though.

Refill them when/where?  In source code?
When displayed in `*Help*' (after `C-x C-q')?

Why can't you do that now?  Or just what do you
mean by "on the fly", here?

And what "user customizations" are you looking
for?  You can certainly customize `fill-column'.

Or you can add a function (to set `fill-column'
to some value) to `help-mode-hook', in effect
customizing it buffer-locally.

And you can use `M-q` in `*Help*' to refill any
paragraphs to your custom column (or "on the fly"
to any other column, if you use `C-x f').

If this isn't enough then `M-x report-emacs-bug'
to request your particular enhancement.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]