GNU bug report logs - #31683
emacs-lisp-intro.texi - opportunity to link eintr to elisp

Previous Next

Package: emacs;

Reported by: Van L <van <at> scratch.space>

Date: Sat, 2 Jun 2018 10:41:01 UTC

Severity: normal

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Van L <van <at> scratch.space>
Subject: bug#31683: closed (Re: bug#31683: emacs-lisp-intro.texi -
 opportunity to link eintr to elisp)
Date: Sat, 02 Jun 2018 11:37:02 +0000
[Message part 1 (text/plain, inline)]
Your bug report

#31683: emacs-lisp-intro.texi - opportunity to link eintr to elisp

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 31683 <at> debbugs.gnu.org.

-- 
31683: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=31683
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Eli Zaretskii <eliz <at> gnu.org>
To: Van L <van <at> scratch.space>
Cc: 31683-done <at> debbugs.gnu.org
Subject: Re: bug#31683: emacs-lisp-intro.texi - opportunity to link eintr to
 elisp
Date: Sat, 02 Jun 2018 14:36:12 +0300
> From: Van L <van <at> scratch.space>
> Date: Sat, 2 Jun 2018 20:39:49 +1000
> 
> The footnote at line 2150 *indirectly* links to (elisp) Printed Representation, which details what an expression is.
> 
> : 8cda6f8f44b (Glenn Morris             2007-09-06  2150) learn how to read it.@footnote{@code{(quote hello)} is an expansion of

I don't think I agree: the relation to expressions is too far-fetched
here.

> At line 2508 in the summary is an opportunity to *directly* link the mention of expressions to (elisp) Printed Representation.
> 
> : 8cda6f8f44b (Glenn Morris             2007-09-06  2508) Lisp programs are made up of expressions, which are lists or single atoms.

Expressions were explained in the previous sub-sections, so I don't
think we need to add a cross-reference here.  (In any case, having
cross-references in a Summary is IME bad style, since it means we
failed to describe something in the parts being summarized.  A summary
should never say anything that wasn't already said before.)

> (I will re-open this bug number for future opportunities to link eintr, elisp after it is closed.)

Please don't, as each issue should be a separate bug report.

[Message part 3 (message/rfc822, inline)]
From: Van L <van <at> scratch.space>
To: bug-gnu-emacs <at> gnu.org
Subject: emacs-lisp-intro.texi - opportunity to link eintr to elisp
Date: Sat, 2 Jun 2018 20:39:49 +1000
Hello.

The footnote at line 2150 *indirectly* links to (elisp) Printed Representation, which details what an expression is.

: 8cda6f8f44b (Glenn Morris             2007-09-06  2150) learn how to read it.@footnote{@code{(quote hello)} is an expansion of

At line 2508 in the summary is an opportunity to *directly* link the mention of expressions to (elisp) Printed Representation.

: 8cda6f8f44b (Glenn Morris             2007-09-06  2508) Lisp programs are made up of expressions, which are lists or single atoms.

(I will re-open this bug number for future opportunities to link eintr, elisp after it is closed.)


This bug report was last modified 7 years and 72 days ago.

Previous Next


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