GNU bug report logs - #73426
[EPA Manual] HTML error suppresses a Lisp example

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 73426 in the body.
You can then email your comments to 73426 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: Thérèse Godefroy <godef.th <at> free.fr>
To: bug-gnu-emacs <at> gnu.org
Subject: [EPA Manual] HTML error suppresses a Lisp example
Date: Sun, 22 Sep 2024 19:43:12 +0200

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

Hello,

While checking a few manuals to improve the main stylesheet [0], I
noticed a bug in the EasyPG Assistant manual: the first Lisp example is
blank! After fixing the markup, this example is displayed normally
(compare the attached screenshots).

The MH-E manual has the same error. I didn't check the other Emacs
manuals.

emacs-manual.patch (attached) fixes the markup.

[ By the way, the MH-E manual says it was last updated on 2016-04-29,
but the copyright line is:
Copyright © 1995, 2001—2003, 2005—2024 Free Software Foundation, Inc. ]

Best,
Thérèse

[0] https://www.gnu.org/style.css
Suggestions to improve this stylesheet are appreciated.

[epa-unfixed.png (image/png, attachment)]

[epa-fixed.png (image/png, attachment)]

[emacs-manual.patch.gz (application/gzip, attachment)]

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Thérèse Godefroy <godef.th <at> free.fr>
Cc: 73426 <at> debbugs.gnu.org
Subject: Re: bug#73426: [EPA Manual] HTML error suppresses a Lisp example
Date: Sun, 22 Sep 2024 21:12:41 +0300

> Date: Sun, 22 Sep 2024 19:43:12 +0200
> From: Thérèse Godefroy <godef.th <at> free.fr>
> 
> While checking a few manuals to improve the main stylesheet [0], I
> noticed a bug in the EasyPG Assistant manual: the first Lisp example is
> blank! After fixing the markup, this example is displayed normally
> (compare the attached screenshots).

Thanks, but the fix must not be in the HTML files, because those are
generated.  We need to find out why Texinfo and/or the scripts we run
after it produce this result, and fix that.

I will take a look when I have time, if no one beats me to it.

> [ By the way, the MH-E manual says it was last updated on 2016-04-29,
> but the copyright line is:
> Copyright © 1995, 2001—2003, 2005—2024 Free Software Foundation, Inc. ]

That's not a problem: we add a year to the Copyright years each year,
regardless of whether the file has been changed or not.

Message #13 received at 73426-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: godef.th <at> free.fr
Cc: 73426-done <at> debbugs.gnu.org
Subject: Re: bug#73426: [EPA Manual] HTML error suppresses a Lisp example
Date: Sat, 28 Sep 2024 13:50:11 +0300

> Cc: 73426 <at> debbugs.gnu.org
> Date: Sun, 22 Sep 2024 21:12:41 +0300
> From: Eli Zaretskii <eliz <at> gnu.org>
> 
> > Date: Sun, 22 Sep 2024 19:43:12 +0200
> > From: Thérèse Godefroy <godef.th <at> free.fr>
> > 
> > While checking a few manuals to improve the main stylesheet [0], I
> > noticed a bug in the EasyPG Assistant manual: the first Lisp example is
> > blank! After fixing the markup, this example is displayed normally
> > (compare the attached screenshots).
> 
> Thanks, but the fix must not be in the HTML files, because those are
> generated.  We need to find out why Texinfo and/or the scripts we run
> after it produce this result, and fix that.
> 
> I will take a look when I have time, if no one beats me to it.

I've now reviewed all these changes (there were a lot more of them
than just the two you found), and discovered that they were due to a
dangerous editing by admin/admin.el which was already removed as part
of fixing bug#72761.

So I have fixed the affected HTML files manually, and I'm therefore
closing this bug.  Thank you for drawing our attention to this issue.

Previous Next

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