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

[Heime]

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

> > Date: Thu, 14 Sep 2023 10:41:06 +0000
> > From: Heime heimeborgia@protonmail.com
> > Cc: uzibalqa uzibalqa@proton.me, 65913@debbugs.gnu.org, 
> > stefankangas@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.