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

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#31683: closed (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 message dated Sat, 02 Jun 2018 14:36:12 +0300
with message-id <83bmcte7yr.fsf <at> gnu.org>
and subject line Re: bug#31683: emacs-lisp-intro.texi - opportunity to link eintr to elisp
has caused the debbugs.gnu.org bug report #31683,
regarding emacs-lisp-intro.texi - opportunity to link eintr to elisp
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> 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: 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.)

[Message part 3 (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.

Previous Next

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