GNU bug report logs - #65913
with-help-window arranges for 'inhibit-read-only' to be set to 't'

Previous Next

Full log

View this message in rfc822 format

From: Heime <heimeborgia <at> protonmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: uzibalqa <at> proton.me, stefankangas <at> gmail.com, 65913 <at> debbugs.gnu.org
Subject: bug#65913: with-help-window arranges for 'inhibit-read-only' to be set to 't'
Date: Thu, 14 Sep 2023 13:17:43 +0000

------- Original Message -------
On Friday, September 15th, 2023 at 12:50 AM, Eli Zaretskii <eliz <at> gnu.org> wrote:

> > Date: Thu, 14 Sep 2023 10:41:06 +0000
> > From: Heime heimeborgia <at> protonmail.com
> > Cc: uzibalqa uzibalqa <at> proton.me, 65913 <at> debbugs.gnu.org, stefankangas <at> gmail.com
> > 
> > > So do we. But this issue has nothing to do with how hard it is to
> > > work with Emacs. You simply looked for the information you were after
> > > in the wrong place, when the right place should have been pretty
> > > obvious for someone who writes Lisp programs: the ELisp manual.
> > 
> > Stefan mentioned a project to have the docstring communicate with the manual
> > so that finding the information will not be too laborious.
> 
> 
> That's an existing feature, we use it when appropriate.
> 
> > > In general, there's no need to mention in each and every doc string
> > > that to learn about some subject you should read the manual where that
> > > subject is described. This is trivial, and having to repeat that
> > > everywhere will just bloat Emacs for no good reason. Consulting the
> > > documentation is one of the first lessons that each Emacs user learns,
> > > and resisting that lesson is not recommended.
> > 
> > There could be some manual or metadata that could provide rapid search
> > and association capabilities to find relevant information and avoid much
> > manual labour.
> 
> We have commands for that: "M-x apropos", Info-index, and others.

Many thanks, shall look into this and see how far that gets me.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.