GNU bug report logs - #72761
issues with Flymake online documentation

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#72761: closed (issues with Flymake online documentation)
Date: Sat, 31 Aug 2024 09:49:02 +0000

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

Your message dated Sat, 31 Aug 2024 12:46:54 +0300
with message-id <86zfotausx.fsf <at> gnu.org>
and subject line Re: bug#72761: issues with Flymake online documentation
has caused the debbugs.gnu.org bug report #72761,
regarding issues with Flymake online documentation
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
72761: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=72761
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Lester Longley <lester <at> ieee.org>
To: bug-gnu-emacs <at> gnu.org
Subject: issues with Flymake online documentation
Date: Thu, 22 Aug 2024 12:43:23 -0400

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

Hello,

I see two issues at manual page:
https://www.gnu.org/software/emacs/manual/html_mono/flymake.html

(1) in sentence "See Eglot Features
<https://www.gnu.org/software/emacs/manual/html_mono/eglot.html#Eglot-Features>
 in Eglot: The Emacs LSP Client Flymake is also designed to be easily
extended to support new backends via an Elisp interface.",
the embedded link
https://www.gnu.org/software/emacs/manual/html_node/eglot_html/Eglot-Features.html#Eglot-Features
doesn't work (404 error)
I think the correct link should be:
https://www.gnu.org/software/emacs/manual/html_node/eglot/Eglot-Features.html#Eglot-Features

The same issue is present at the "html_node" page
https://www.gnu.org/software/emacs/manual/html_node/flymake/index.html

(2) the section
https://www.gnu.org/software/emacs/manual/html_mono/flymake.html#Mode-line-status
is empty, when I view it in Chrome 127, on a Chromebook, or in Chrome, on
an Android phone.
Here's browser snapshot from Chromebook; Android phone gives similar view:

[image: image.png]

The "empty" section is a table:

    @multitable @columnfractions 0.25 0.75
    ...
    @end multitable

This results in what appears (to me) to be normal HTML for a table
(excerpted from Chrome's view-source)

    <p>The following statuses are defined:
    </p>
    <table>
    <tr><td width="25%">[<var>nerrors</var> <var>nwarnings</var>
...]</td><td width="75%">Normal operation. <var>nerrors</var> and
<var>nwarnings</var> are, respectively,
    the total number of errors and warnings found during the last buffer
    check, for all backends. They may be followed by other totals for
    other types of diagnostics (see <a
href="#Flymake-error-types">Customizing Flymake error types</a>).</td></tr>
    <tr><td width="25%"><code>Wait</code></td><td width="75%">Some Flymake
backends haven&rsquo;t reported since the last time they
    where questioned.  It is reasonable to assume that this is a temporary
    delay and Flymake will resume normal operation soon.</td></tr>
    <tr><td width="25%"><code>!</code></td><td width="75%">All the
configured Flymake backends have disabled themselves: Flymake
    cannot annotate the buffer and action from the user is needed to
    investigate and remedy the situation (see <a
href="#Troubleshooting">Troubleshooting</a>).</td></tr>
    <tr><td width="25%"><code>?</code></td><td width="75%">There are no
applicable Flymake backends for this buffer, thus Flymake
    cannot annotate it.  To fix this, a user may look to extending Flymake
    and add a new backend (see <a href="#Extending-Flymake">Extending
Flymake</a>).</td></tr>
    </table>

Just in case, I tried toggling light/dark theme but didn't see the expected
table appear.

A clue, perhaps, from Chrome DevTools is that Chrome seems to parse *two*
tables here:

[image: image.png]

Yet this same table looks fine here:
https://www.gnu.org/software/emacs/manual/html_node/flymake/Mode-line-status.html

Also, for reference, in "eww", this section shows the expected table:

[image: image.png]

I don't see any recent changes in
https://git.savannah.gnu.org/cgit/emacs.git/tree/doc/misc/flymake.texi?h=emacs-30
which
might pertain to these issues.

Regards,
Lester

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

[image.png (image/png, inline)]

[image.png (image/png, inline)]

[image.png (image/png, inline)]

[Message part 8 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: Lester Longley <lester <at> ieee.org>
Cc: 72761-done <at> debbugs.gnu.org
Subject: Re: bug#72761: issues with Flymake online documentation
Date: Sat, 31 Aug 2024 12:46:54 +0300

> From: Lester Longley <lester <at> ieee.org>
> Date: Sun, 25 Aug 2024 10:06:02 -0400
> Cc: 72761 <at> debbugs.gnu.org
> 
> Hi Eli,
> 
> On Sun, Aug 25, 2024 at 8:48 AM Eli Zaretskii <eliz <at> gnu.org> wrote:
> > Thanks, I've now fixed the relevant HTML page, and also modified the
> > script we use to produce HTML manuals to not perform this kind of
> > "editing" of HTML produced by makeinfo.
> 
> Thank you very much.  The Flymake manuals work fine now, as regards both issues.
> 
> (And the update you made to "admin/admin.el" was instructive, for me,
> re: the manual-generation infrastructure.)

Thanks, I'm therefore closing this bug.

Previous Next

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