Emacs Lisp Reference Manual

Emacs Lisp Reference Manual

[Christopher Dimech]

Can we have the Emacs Lisp Reference Manual enumerate the @menu items
so it would be easier to refer people to it.

Regards
C*

---------------------
Christopher Dimech
General Administrator - Naiad Informatics - GNU Project (Geocomputation)
- Geophysical Simulation
- Geological Subsurface Mapping
- Disaster Preparedness and Mitigation
- Natural Resource Exploration and Production
- Free Software Advocacy

Re: Emacs Lisp Reference Manual

[Eli Zaretskii]

> From: Christopher Dimech <dimech@gmx.com>
> Date: Fri, 27 Nov 2020 21:42:08 +0100
> 
> Can we have the Emacs Lisp Reference Manual enumerate the @menu items
> so it would be easier to refer people to it.

The chapters and sections in the produced manual are already numbered.

Re: Emacs Lisp Reference Manual

[Christopher Dimech]

Correct, but not in the menu.

See
https://www.gnu.org/software/emacs/manual/html_node/elisp/index.html



> Sent: Friday, November 27, 2020 at 9:55 PM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: help-gnu-emacs@gnu.org
> Subject: Re: Emacs Lisp Reference Manual
>
> > From: Christopher Dimech <dimech@gmx.com>
> > Date: Fri, 27 Nov 2020 21:42:08 +0100
> >
> > Can we have the Emacs Lisp Reference Manual enumerate the @menu items
> > so it would be easier to refer people to it.
>
> The chapters and sections in the produced manual are already numbered.
>
>

Re: Emacs Lisp Reference Manual

[Eli Zaretskii]

> From: Christopher Dimech <dimech@gmx.com>
> Cc: help-gnu-emacs@gnu.org
> Date: Fri, 27 Nov 2020 22:18:30 +0100
> Sensitivity: Normal
> 
> Correct, but not in the menu.

The menu is just a list of pointers with no real content.  Why would
you need to refer people to the menu rather than to the stuff it
points to?

Re: Emacs Lisp Reference Manual

[Christopher Dimech]

If one is using a Web Browser, it is much quicker to find if
you say "See 10.4 Backquote".  You just scroll to 10, then to
four, rather than by a Brain Regexp.

> Sent: Saturday, November 28, 2020 at 8:28 AM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: help-gnu-emacs@gnu.org
> Subject: Re: Emacs Lisp Reference Manual
>
> > From: Christopher Dimech <dimech@gmx.com>
> > Cc: help-gnu-emacs@gnu.org
> > Date: Fri, 27 Nov 2020 22:18:30 +0100
> > Sensitivity: Normal
> >
> > Correct, but not in the menu.
>
> The menu is just a list of pointers with no real content.  Why would
> you need to refer people to the menu rather than to the stuff it
> points to?
>
>

Re: Emacs Lisp Reference Manual

[Eli Zaretskii]

> From: Christopher Dimech <dimech@gmx.com>
> Cc: help-gnu-emacs@gnu.org
> Date: Sat, 28 Nov 2020 12:14:28 +0100
> 
> If one is using a Web Browser, it is much quicker to find if
> you say "See 10.4 Backquote".  You just scroll to 10, then to
> four, rather than by a Brain Regexp.

So this is only relevant to the HTML output?  Because in Info you just
use the 'g' command, which prompts for the name of the node to go to.

Re: Emacs Lisp Reference Manual

[Christopher Dimech]

Yes, just about the html code when one is using a browser.  In info it is easy
to do the search.  I informed the Gavin and Patrice, to see what can be done on
how texinfo processes the menu for html.

---------------------
Christopher Dimech
General Administrator - Naiad Informatics - GNU Project (Geocomputation)
- Geophysical Simulation
- Geological Subsurface Mapping
- Disaster Preparedness and Mitigation
- Natural Resource Exploration and Production
- Free Software Advocacy


> Sent: Saturday, November 28, 2020 at 5:12 PM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: help-gnu-emacs@gnu.org
> Subject: Re: Emacs Lisp Reference Manual
>
> > From: Christopher Dimech <dimech@gmx.com>
> > Cc: help-gnu-emacs@gnu.org
> > Date: Sat, 28 Nov 2020 12:14:28 +0100
> >
> > If one is using a Web Browser, it is much quicker to find if
> > you say "See 10.4 Backquote".  You just scroll to 10, then to
> > four, rather than by a Brain Regexp.
>
> So this is only relevant to the HTML output?  Because in Info you just
> use the 'g' command, which prompts for the name of the node to go to.
>
>

Re: Emacs Lisp Reference Manual

[Michael Heerdegen]

Christopher Dimech <dimech@gmx.com> writes:

> Can we have the Emacs Lisp Reference Manual enumerate the @menu items
> so it would be easier to refer people to it.

BTW, one very convenient way to do that is to send them the result of
hitting C-u 0 w.

Michael.

Re: Emacs Lisp Reference Manual

[tomas]

[-- Attachment #1: Type: text/plain, Size: 399 bytes --]

On Fri, Nov 27, 2020 at 10:06:00PM +0100, Michael Heerdegen wrote:
> Christopher Dimech <dimech@gmx.com> writes:
> 
> > Can we have the Emacs Lisp Reference Manual enumerate the @menu items
> > so it would be easier to refer people to it.
> 
> BTW, one very convenient way to do that is to send them the result of
> hitting C-u 0 w.

Learnt something new. Nifty, thanks :)

Cheers
 - t

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

RE: Emacs Lisp Reference Manual

[Drew Adams]

> Can we have the Emacs Lisp Reference Manual enumerate the @menu items
> so it would be easier to refer people to it.

To make an enhancement request (or a bug report):
`M-x report-emacs-bug'.

Re: RE: Emacs Lisp Reference Manual

[Christopher Dimech]

> Sent: Saturday, November 28, 2020 at 2:37 AM
> From: "Drew Adams" <drew.adams@oracle.com>
> To: "Christopher Dimech" <dimech@gmx.com>, "Help Gnu Emacs" <help-gnu-emacs@gnu.org>
> Subject: RE: Emacs Lisp Reference Manual
>
> > Can we have the Emacs Lisp Reference Manual enumerate the @menu items
> > so it would be easier to refer people to it.
>
> To make an enhancement request (or a bug report):
> `M-x report-emacs-bug'.

Done.  Thanks Drew.

Re: Emacs Lisp Reference Manual

[Eli Zaretskii]

> Date: Fri, 27 Nov 2020 17:37:15 -0800 (PST)
> From: Drew Adams <drew.adams@oracle.com>
> 
> > Can we have the Emacs Lisp Reference Manual enumerate the @menu items
> > so it would be easier to refer people to it.
> 
> To make an enhancement request (or a bug report):
> `M-x report-emacs-bug'.

_If_ there's a bug (and that's a big "if", IMNSHO), then the report
should go to the Texinfo developers, because Emacs just uses what
'makeinfo' produces.

Re: Emacs Lisp Reference Manual

[Christopher Dimech]

> Sent: Saturday, November 28, 2020 at 9:02 AM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: help-gnu-emacs@gnu.org
> Subject: Re: Emacs Lisp Reference Manual
>
> > Date: Fri, 27 Nov 2020 17:37:15 -0800 (PST)
> > From: Drew Adams <drew.adams@oracle.com>
> >
> > > Can we have the Emacs Lisp Reference Manual enumerate the @menu items
> > > so it would be easier to refer people to it.
> >
> > To make an enhancement request (or a bug report):
> > `M-x report-emacs-bug'.
>
> _If_ there's a bug (and that's a big "if", IMNSHO), then the report
> should go to the Texinfo developers, because Emacs just uses what
> 'makeinfo' produces.

I could see into that.