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

Previous Next

Full log

Message #63 received at 65913 <at> debbugs.gnu.org (full text, mbox):

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

> 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.

Previous Next

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