* bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp
@ 2018-04-03 6:33 Marcin Borkowski
2018-04-03 7:34 ` Eli Zaretskii
2019-09-28 18:29 ` Stefan Kangas
0 siblings, 2 replies; 6+ messages in thread
From: Marcin Borkowski @ 2018-04-03 6:33 UTC (permalink / raw)
To: 31037
(info "eintro")
yields
--8<---------------cut here---------------start------------->8---
An Introduction to Programming in Emacs Lisp
********************************************
This is an ‘Introduction to Programming in Emacs Lisp’, for people who
--8<---------------cut here---------------end--------------->8---
If I want to actually cite Chassell's book, it is (a) not obvious who
the author is (the name can be found at the end of the preface and in
the "About the author" section, but not on the title page, where it
should be!), and (b) completely not obvious how to cite the book - is
the official title "An Introduction to Programming in Emacs Lisp" or
"Introduction to Programming in Emacs Lisp"?
Best,
--
Marcin Borkowski
http://mbork.pl
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp
2018-04-03 6:33 bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp Marcin Borkowski
@ 2018-04-03 7:34 ` Eli Zaretskii
2018-04-05 10:38 ` Marcin Borkowski
2019-09-28 18:29 ` Stefan Kangas
1 sibling, 1 reply; 6+ messages in thread
From: Eli Zaretskii @ 2018-04-03 7:34 UTC (permalink / raw)
To: Marcin Borkowski; +Cc: 31037
> From: Marcin Borkowski <mbork@mbork.pl>
> Date: Tue, 03 Apr 2018 08:33:39 +0200
>
> (info "eintro")
>
> yields
>
> --8<---------------cut here---------------start------------->8---
> An Introduction to Programming in Emacs Lisp
> ********************************************
>
> This is an ‘Introduction to Programming in Emacs Lisp’, for people who
> --8<---------------cut here---------------end--------------->8---
>
> If I want to actually cite Chassell's book, it is (a) not obvious who
> the author is (the name can be found at the end of the preface and in
> the "About the author" section, but not on the title page, where it
> should be!), and (b) completely not obvious how to cite the book - is
> the official title "An Introduction to Programming in Emacs Lisp" or
> "Introduction to Programming in Emacs Lisp"?
You are looking in the wrong place for this information. The Info
format of a book is not a book, it's an on-line documentation file.
For the book details, you should either (a) look at the Texinfo
sources, or (b) produce a PDF or DVI/PS format, and look there. (The
former is much easier, of course, if you have the sources.)
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp
2018-04-03 7:34 ` Eli Zaretskii
@ 2018-04-05 10:38 ` Marcin Borkowski
0 siblings, 0 replies; 6+ messages in thread
From: Marcin Borkowski @ 2018-04-05 10:38 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: 31037
On 2018-04-03, at 09:34, Eli Zaretskii <eliz@gnu.org> wrote:
>> From: Marcin Borkowski <mbork@mbork.pl>
>> Date: Tue, 03 Apr 2018 08:33:39 +0200
>>
>> (info "eintro")
>>
>> yields
>>
>> --8<---------------cut here---------------start------------->8---
>> An Introduction to Programming in Emacs Lisp
>> ********************************************
>>
>> This is an ‘Introduction to Programming in Emacs Lisp’, for people who
>> --8<---------------cut here---------------end--------------->8---
>>
>> If I want to actually cite Chassell's book, it is (a) not obvious who
>> the author is (the name can be found at the end of the preface and in
>> the "About the author" section, but not on the title page, where it
>> should be!), and (b) completely not obvious how to cite the book - is
>> the official title "An Introduction to Programming in Emacs Lisp" or
>> "Introduction to Programming in Emacs Lisp"?
>
> You are looking in the wrong place for this information. The Info
> format of a book is not a book, it's an on-line documentation file.
> For the book details, you should either (a) look at the Texinfo
> sources, or (b) produce a PDF or DVI/PS format, and look there. (The
> former is much easier, of course, if you have the sources.)
I disagree. A book is a book, it shouldn't matter whether its dead
wood, pdf, html, texi or info.
Also, the pdf says (p. 3)
"An Introduction to Programming in Emacs Lisp",
then
"This is an /Introduction to Programming in Emacs Lisp/, for people who
are not programmers." (p. 4),
and then
"This introduction to /Programming in Emacs Lisp/ has a companion
document" (p. 14).
So the pdf is also kind of a mess. Still looks like a bug to me.
Best,
--
Marcin Borkowski
http://mbork.pl
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp
2018-04-03 6:33 bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp Marcin Borkowski
2018-04-03 7:34 ` Eli Zaretskii
@ 2019-09-28 18:29 ` Stefan Kangas
2019-10-01 15:33 ` Marcin Borkowski
1 sibling, 1 reply; 6+ messages in thread
From: Stefan Kangas @ 2019-09-28 18:29 UTC (permalink / raw)
To: Marcin Borkowski; +Cc: 31037
[-- Attachment #1: Type: text/plain, Size: 2589 bytes --]
Marcin Borkowski <mbork@mbork.pl> writes:
>>> (info "eintro")
>>>
>>> yields
>>>
>>> --8<---------------cut here---------------start------------->8---
>>> An Introduction to Programming in Emacs Lisp
>>> ********************************************
>>>
>>> This is an ‘Introduction to Programming in Emacs Lisp’, for people who
>>> --8<---------------cut here---------------end--------------->8---
>>>
>>> If I want to actually cite Chassell's book, it is (a) not obvious who
>>> the author is (the name can be found at the end of the preface and in
>>> the "About the author" section, but not on the title page, where it
>>> should be!), and (b) completely not obvious how to cite the book - is
>>> the official title "An Introduction to Programming in Emacs Lisp" or
>>> "Introduction to Programming in Emacs Lisp"?
>>
>> You are looking in the wrong place for this information. The Info
>> format of a book is not a book, it's an on-line documentation file.
>> For the book details, you should either (a) look at the Texinfo
>> sources, or (b) produce a PDF or DVI/PS format, and look there. (The
>> former is much easier, of course, if you have the sources.)
>
> I disagree. A book is a book, it shouldn't matter whether its dead
> wood, pdf, html, texi or info.
>
> Also, the pdf says (p. 3)
>
> "An Introduction to Programming in Emacs Lisp",
>
> then
>
> "This is an /Introduction to Programming in Emacs Lisp/, for people who
> are not programmers." (p. 4),
>
> and then
>
> "This introduction to /Programming in Emacs Lisp/ has a companion
> document" (p. 14).
>
> So the pdf is also kind of a mess. Still looks like a bug to me.
It seems to me that the canonical title is "An Introduction to
Programming in Emacs Lisp". That's what's available at:
https://shop.fsf.org/books/signed-introduction-programming-emacs-lisp-3rd-edition
I also find in emacs-lisp-intro.texi:
> @c half title; two lines here, so do not use 'shorttitlepage'
> @tex
> {\begingroup%
> \hbox{}\vskip 1.5in \chaprm \centerline{An Introduction to}%
> \endgroup}%
> {\begingroup\hbox{}\vskip 0.25in \chaprm%
> \centerline{Programming in Emacs Lisp}%
> \endgroup\page\hbox{}\page}
> @end tex
>
> @titlepage
> @sp 6
> @center @titlefont{An Introduction to}
> @sp 2
> @center @titlefont{Programming in Emacs Lisp}
> @sp 2
> @center Revised Third Edition
> @sp 4
> @center by Robert J. Chassell
The attached patch fixes the reported inconsistencies. Any objections?
Best regards,
Stefan Kangas
[-- Attachment #2: 0001-Fix-title-inconsistencies-in-elisp-intro-book.patch --]
[-- Type: text/x-patch, Size: 1216 bytes --]
From 117c3c7f54dc68b433e279793f8017eeef0d63fa Mon Sep 17 00:00:00 2001
From: Stefan Kangas <stefankangas@gmail.com>
Date: Sat, 28 Sep 2019 20:27:10 +0200
Subject: [PATCH] Fix title inconsistencies in elisp intro book
* doc/lispintro/emacs-lisp-intro.texi: Fix title
inconsistencies. (Bug#31037)
---
doc/lispintro/emacs-lisp-intro.texi | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi
index 22ea655d59..3e43f7f09f 100644
--- a/doc/lispintro/emacs-lisp-intro.texi
+++ b/doc/lispintro/emacs-lisp-intro.texi
@@ -103,7 +103,7 @@
@end direntry
@copying
-This is an @cite{Introduction to Programming in Emacs Lisp}, for
+This is @cite{An Introduction to Programming in Emacs Lisp}, for
people who are not programmers.
@sp 1
@iftex
@@ -892,8 +892,8 @@ Who You Are
paragraphs. This book is intended as an approachable hill, rather than
as a daunting mountain.
-This introduction to @cite{Programming in Emacs Lisp} has a companion
-document,
+This book, @cite{An Introduction to Programming in Emacs Lisp}, has a
+companion document,
@iftex
@cite{The GNU Emacs Lisp Reference Manual}.
@end iftex
--
2.20.1
^ permalink raw reply related [flat|nested] 6+ messages in thread
* bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp
2019-09-28 18:29 ` Stefan Kangas
@ 2019-10-01 15:33 ` Marcin Borkowski
2019-10-08 16:31 ` Stefan Kangas
0 siblings, 1 reply; 6+ messages in thread
From: Marcin Borkowski @ 2019-10-01 15:33 UTC (permalink / raw)
To: Stefan Kangas; +Cc: 31037
On 2019-09-28, at 20:29, Stefan Kangas <stefan@marxist.se> wrote:
> The attached patch fixes the reported inconsistencies. Any objections?
No, thanks. (I'm not sure if all inconsistencies are solved, but at
least this is a step in the right direction.)
Thanks,
--
Marcin Borkowski
http://mbork.pl
^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp
2019-10-01 15:33 ` Marcin Borkowski
@ 2019-10-08 16:31 ` Stefan Kangas
0 siblings, 0 replies; 6+ messages in thread
From: Stefan Kangas @ 2019-10-08 16:31 UTC (permalink / raw)
To: Marcin Borkowski; +Cc: 31037
close 31037 27.1
thanks
Marcin Borkowski <mbork@mbork.pl> writes:
> > The attached patch fixes the reported inconsistencies. Any objections?
>
> No, thanks. (I'm not sure if all inconsistencies are solved, but at
> least this is a step in the right direction.)
No other comments in 10 days, so I've now pushed this as commit
1793d4979b. Closing this bug.
Best regards,
Stefan Kangas
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2019-10-08 16:31 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-04-03 6:33 bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp Marcin Borkowski
2018-04-03 7:34 ` Eli Zaretskii
2018-04-05 10:38 ` Marcin Borkowski
2019-09-28 18:29 ` Stefan Kangas
2019-10-01 15:33 ` Marcin Borkowski
2019-10-08 16:31 ` Stefan Kangas
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).