bug#73426: [EPA Manual] HTML error suppresses a Lisp example

bug#73426: [EPA Manual] HTML error suppresses a Lisp example

[Thérèse Godefroy]

[-- Attachment #1: Type: text/plain, Size: 661 bytes --]

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.

[-- Attachment #2: epa-unfixed.png --]
[-- Type: image/png, Size: 59824 bytes --]

[-- Attachment #3: epa-fixed.png --]
[-- Type: image/png, Size: 60243 bytes --]

[-- Attachment #4: emacs-manual.patch.gz --]
[-- Type: application/gzip, Size: 710 bytes --]

bug#73426: [EPA Manual] HTML error suppresses a Lisp example

[Eli Zaretskii]

> Date: Sun, 22 Sep 2024 19:43:12 +0200
> From: Thérèse Godefroy <godef.th@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.

bug#73426: [EPA Manual] HTML error suppresses a Lisp example

[Eli Zaretskii]

> Cc: 73426@debbugs.gnu.org
> Date: Sun, 22 Sep 2024 21:12:41 +0300
> From: Eli Zaretskii <eliz@gnu.org>
> 
> > Date: Sun, 22 Sep 2024 19:43:12 +0200
> > From: Thérèse Godefroy <godef.th@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.