bug-gnu-emacs
[Top][All Lists]
Advanced

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

bug#46702: Link symbol name in Help


From: Eli Zaretskii
Subject: bug#46702: Link symbol name in Help
Date: Thu, 25 Feb 2021 17:29:38 +0200

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: laszlomail@protonmail.com,  46702@debbugs.gnu.org
> Date: Thu, 25 Feb 2021 16:15:03 +0100
> 
> > The "How to resize mini-windows..." part begins "out of the blue".
> > It's actually incorrect English (incomplete sentence), AFAIK.  It
> > reads okay-ish when the first line is alone, or when the text follows
> > some heading, like "Documentation:", but that is gone now.
> 
> I don't think the "Documentation:" line helps much here, though.  It's
> just an awkward first line.

I didn't say we should reinstate that line, did I?

> But even if the buffer started with:
> 
>   resize-mini-windows is a variable defined in ‘C source code’.
> 
>   How to resize mini-windows (the minibuffer and the echo area).
>   A value of nil means don’t automatically resize mini-windows.
> 
> It'd still be an awkward doc string, because it's just an awkward
> semi-sentence.

Which is why I said we may wish rewriting it (and others like it, of
which we have quite a few, I think).





reply via email to

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