bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#31037: 27.0.50; Misleading info in Introduction to Programming in Em


From: Marcin Borkowski
Subject: bug#31037: 27.0.50; Misleading info in Introduction to Programming in Emacs Lisp
Date: Thu, 05 Apr 2018 12:38:53 +0200
User-agent: mu4e 1.1.0; emacs 27.0.50

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





reply via email to

[Prev in Thread] Current Thread [Next in Thread]