GNU bug report logs - #46084
26.3; Elisp manual: provide a link to (eintro) up front

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Sun, 24 Jan 2021 18:57:01 UTC

Severity: wishlist

Found in version 26.3

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>, "rms <at> gnu.org" <rms <at> gnu.org>
Cc: "larsi <at> gnus.org" <larsi <at> gnus.org>, "46084 <at> debbugs.gnu.org" <46084 <at> debbugs.gnu.org>
Subject: bug#46084: [External] : Re: bug#46084: 26.3; Elisp manual: provide a link to (eintro) up front
Date: Thu, 28 Jan 2021 15:16:09 +0000
> > I agree, let's make the link.  It costs almost nothing on any
> > dimension, and you're right that it will help some people.
> 
> Did anyone look in the ELisp manual before writing about this issue?

Yes, I did.

> Because there is already a link.

Not that I see.  At least not in Emacs 26.3
(or 27.1, or the latest 28 MS Windows
snapshot I have).

> The ELisp manual says in its first chapter, "Introduction":
> 
>      This manual attempts to be a full description of Emacs Lisp.  For
> a
>   beginner’s introduction to Emacs Lisp, see ‘An Introduction to Emacs
>   Lisp Programming’, by Bob Chassell, also published by the Free
> Software
>   Foundation.  This manual presumes considerable familiarity with the
> use
>   of Emacs for editing; see ‘The GNU Emacs Manual’ for this basic
>   information.
> 
> What else is missing?

A link (as the enhancement request says).  Not just
a textual mention of the manual's title, but an Info
link.
___

And while we're at it, please consider adding a link
(a link) to the Emacs manual, as well.

Textual references are great.  Linked textual refs
are even better.
___

BTW, "This manual" can be misunderstood in the last
sentence you quoted.  We presumably want it to mean,
like the first "This manual" of the paragraph, the
Elisp manual.  But immediately following mention of
Eintr, it becomes a bit ambiguous.  Better to make
explicit which manual is meant.


This bug report was last modified 4 years and 170 days ago.

Previous Next


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