From: Lester Longley via "Bug reports for GNU Emacs, the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
To: Eli Zaretskii <eliz@gnu.org>
Cc: 72761@debbugs.gnu.org
Subject: bug#72761: issues with Flymake online documentation
Date: Thu, 22 Aug 2024 17:01:37 -0400 [thread overview]
Message-ID: <CAA3095_svHT+j9O9+LmS5UjkFfKhaFy-jKj8-+Roy-ZsuRumhw@mail.gmail.com> (raw)
In-Reply-To: <86wmk8qsgs.fsf@gnu.org>
[-- Attachment #1: Type: text/plain, Size: 3487 bytes --]
Hi Eli,
Thanks for looking at that further.
Re: the second issue, the problem seems to start here, with this: <table
style="float:left" width="100%"> element (see PROBLEM below), which
(a) seems out of place
(b) is never closed w/ "</table>, as best I can see (as per inspection of
saved output from curl "
https://www.gnu.org/software/emacs/manual/html_mono/flymake.html")
Instead, this "<table>" seems to be closed with a mismatched "</ul>"
<p>Syntax checks happen “on-the-fly”. Each check is
started whenever:
</p>
<table style="float:left" width="100%"> <== PROBLEM?
<li> <code>flymake-mode</code> is started, unless
<code>flymake-start-on-flymake-mode</code> is
<code>nil</code>;
</li><li> the buffer is saved, unless
<code>flymake-start-on-save-buffer</code> is
<code>nil</code>;
</li><li> some changes were made to the buffer more than
<code>0.5</code> seconds ago
(the delay is configurable in
<code>flymake-no-changes-timeout</code>).
</li><li> When the user invokes the command
<code>flymake-start</code>.
</li></ul> <== PROBLEM?
<p>If the check detected errors or warnings, the respective
buffer
regions are highlighted. See <a
href="#Finding-diagnostics">Finding diagnostics</a>, for how to
learn what the problems are.
</p>
I am unfamiliar w/ Texinfo, but I nonetheless don't see any "obvious"
reason that a <table> element should be emitted at the above location,
based on the below excerpt from
https://git.savannah.gnu.org/cgit/emacs.git/tree/doc/misc/flymake.texi?h=emacs-29#n115
(I'm just guessing on the corresponding version of this file currently used
for the online documentation)
Syntax checks happen ``on-the-fly''. Each check is started whenever:
@itemize @bullet
@item
@code{flymake-mode} is started, unless
@code{flymake-start-on-flymake-mode} is @code{nil};
@item
the buffer is saved, unless @code{flymake-start-on-save-buffer} is
@code{nil};
@item
some changes were made to the buffer more than @code{0.5} seconds ago
(the delay is configurable in @code{flymake-no-changes-timeout}).
@item
When the user invokes the command @code{flymake-start}.
@end itemize
Perhaps this is helpful; if not please pardon & ignore.
On Thu, Aug 22, 2024 at 3:16 PM Eli Zaretskii <eliz@gnu.org> wrote:
> > From: Lester Longley <lester@ieee.org>
> > Date: Thu, 22 Aug 2024 15:07:57 -0400
> > Cc: 72761@debbugs.gnu.org
> >
> > OK, here's a clue re: the first issue.
> >
> > The flymake "nodes" (
> https://www.gnu.org/software/emacs/manual/html_node/flymake/ ) manual
> (attempts) to
> > make a relative "cross link" to the eglot "nodes" manual, like so:
> >
> > <a data-manual="eglot"
> href="../eglot_html/Eglot-Features.html#Eglot-Features">Eglot Features</a>
>
> Yes, that part was evident. The question was why it says
> "eglot_html". And I just found the answer: it's a relatively recent
> change in Texinfo. From the Texinfo NEWS file:
>
> 7.0 (7 November 2022)
> * texi2any
> [...]
> . HTML output:
> . use manual_name_html as output directory for split HTML instead of
> manual_name or manual_name.html
>
> Ugh!
>
[-- Attachment #2: Type: text/html, Size: 5292 bytes --]
next prev parent reply other threads:[~2024-08-22 21:01 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-08-22 16:43 bug#72761: issues with Flymake online documentation Lester Longley via Bug reports for GNU Emacs, the Swiss army knife of text editors
2024-08-22 18:03 ` Eli Zaretskii
2024-08-22 18:21 ` Lester Longley via Bug reports for GNU Emacs, the Swiss army knife of text editors
2024-08-22 18:23 ` Eli Zaretskii
2024-08-22 19:07 ` Lester Longley via Bug reports for GNU Emacs, the Swiss army knife of text editors
2024-08-22 19:15 ` Eli Zaretskii
2024-08-22 21:01 ` Lester Longley via Bug reports for GNU Emacs, the Swiss army knife of text editors [this message]
2024-08-23 7:06 ` Eli Zaretskii
2024-08-23 7:40 ` Lester Longley via Bug reports for GNU Emacs, the Swiss army knife of text editors
2024-08-25 12:48 ` Eli Zaretskii
2024-08-25 14:06 ` Lester Longley via Bug reports for GNU Emacs, the Swiss army knife of text editors
2024-08-31 9:46 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAA3095_svHT+j9O9+LmS5UjkFfKhaFy-jKj8-+Roy-ZsuRumhw@mail.gmail.com \
--to=bug-gnu-emacs@gnu.org \
--cc=72761@debbugs.gnu.org \
--cc=eliz@gnu.org \
--cc=lester@ieee.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.