GNU bug report logs - #31143
elisp manual corrections

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 31143 in the body.
You can then email your comments to 31143 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Tony Kennedy <adk3141 <at> hotmail.com>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
Subject: elisp manual corrections
Date: Thu, 12 Apr 2018 23:36:46 +0000

[Message part 1 (text/plain, inline)]

Hi,

I have made some comments, corrections, and suggestions on the attached PDF copy of the elisp manual. I thought I would send it to you in case you might find it useful.

        Regards,

                -Tony Kennedy-

Tony Kennedy

Flat 13, 28 Simpson Loan, Edinburgh, EH3 9GG, Scotland

+44 131 447 0086 (home)

adk3141 <at> hotmail.com<mailto:adk3141 <at> hotmail.com>

+44 788 182 5458 (mobile)

www.ph.ed.ac.uk/~adk<http://www.ph.ed.ac.uk/~adk>

+44 131 650 5272 (office)

[Message part 2 (text/html, inline)]

[elisp-corrected.pdf (application/pdf, attachment)]

Message #8 received at 31143 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Tony Kennedy <adk3141 <at> hotmail.com>
Cc: 31143 <at> debbugs.gnu.org
Subject: Re: bug#31143: elisp manual corrections
Date: Fri, 13 Apr 2018 16:54:19 +0300

> From: Tony Kennedy <adk3141 <at> hotmail.com>
> Date: Thu, 12 Apr 2018 23:36:46 +0000
> 
> I have made some comments, corrections, and suggestions on the attached PDF copy of the elisp manual. I thought I would send it to you in case you might find it useful.

Thanks for taking time to read the manual and comment on it.

I fixed some typos and other uncontroversial parts of your
suggestions, but left others unhandled, either because they were
already fixed in the current sources (it sounds like you didn't build
the latest version from the Emacs Git repository), or because the
problem was most probably caused by your local configuration (in
particular the fl ligature business: there's nothing wrong with the
Texinfo source in all those cases), or because I disagreed with your
suggestions.  And some comments seem to question the implementation,
not the correctness or clarity of the documentation, or generally
raise issues for which I didn't feel the manual is the right place.

For the future, I suggest to send your comments and corrections citing
the Texinfo sources, not as comments to PDF version of the manual,
because the latter is harder to read.  (I actually encourage you to
resend these comments in that format, to facilitate their discussion
and application.)

Previous Next

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