From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Lester Longley via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#72761: issues with Flymake online documentation Date: Thu, 22 Aug 2024 17:01:37 -0400 Message-ID: References: <868qwosaei.fsf@gnu.org> <8634mws9fm.fsf@gnu.org> <86wmk8qsgs.fsf@gnu.org> Reply-To: Lester Longley Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="000000000000a192f806204bf79e" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6380"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 72761@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Aug 22 23:03:48 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1shEy9-0001SJ-Dj for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 22 Aug 2024 23:03:45 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1shExm-0000gC-Ps; Thu, 22 Aug 2024 17:03:22 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1shExg-0000Ky-Bc for bug-gnu-emacs@gnu.org; Thu, 22 Aug 2024 17:03:16 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1shExg-0005s2-29 for bug-gnu-emacs@gnu.org; Thu, 22 Aug 2024 17:03:16 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=Date:From:In-Reply-To:References:MIME-Version:To:Subject; bh=4WqrKHoNN6SjkjPYFy7n6FJQkGhUWmO5ciU/UFMkdO8=; b=JzwJI9lkVJBBKKeOnMepO+Bii1sMqQuZ+koYexAfs0NOZ70fmUq+N4BfJy1EKMbR8t6U7GUoCXHA9lNIqR6ENdM0rYLC9rHub3cjel9/Tn/u1gtV+a6dFRP7urDH+APvkOTBetCr18otMxtncmY1NP+z3oZgRdjOCtm/jiXOqPS81oK0gX3o0Rl3WsEcyk93n9NRqPFn70j0ZPfXtsZ78OtdJA5d4wZXQK8tZhg8/XYT8pghoe7AZTgYn7ItWIvj2hyn/vmSRrahntiitGFUJn3497fVGmBJC/BsBjTObfyqXtH5YBiucuwp+sSxtiGlcRIt9pIvKwcAtKQMa4ZQUQ==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1shEyQ-0006uX-8R for bug-gnu-emacs@gnu.org; Thu, 22 Aug 2024 17:04:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lester Longley Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 22 Aug 2024 21:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72761 X-GNU-PR-Package: emacs Original-Received: via spool by 72761-submit@debbugs.gnu.org id=B72761.172436062526540 (code B ref 72761); Thu, 22 Aug 2024 21:04:02 +0000 Original-Received: (at 72761) by debbugs.gnu.org; 22 Aug 2024 21:03:45 +0000 Original-Received: from localhost ([127.0.0.1]:38439 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1shEy8-0006tz-VA for submit@debbugs.gnu.org; Thu, 22 Aug 2024 17:03:45 -0400 Original-Received: from mail-lf1-f44.google.com ([209.85.167.44]:60755) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1shEy6-0006tg-5v for 72761@debbugs.gnu.org; Thu, 22 Aug 2024 17:03:43 -0400 Original-Received: by mail-lf1-f44.google.com with SMTP id 2adb3069b0e04-53343bf5eddso1746613e87.1 for <72761@debbugs.gnu.org>; Thu, 22 Aug 2024 14:02:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ieee.org; s=google; t=1724360510; x=1724965310; darn=debbugs.gnu.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=4WqrKHoNN6SjkjPYFy7n6FJQkGhUWmO5ciU/UFMkdO8=; b=SO5yxYgV3Iqd0niLKom9O9ZkOYVwqcuJsWyY5PIhH/zBS7g2c9bGSWvs5o0OzS1boQ Z6BgYFZYTW2QvQiKn5G4P+G30FwVkJxCnhrzAzaq2nmooIS6rFpmgr6e9nfJN36lO/WI U2vwO2Vcqvnmls/RHIK8mlWtE1OFsEFzXKwJI= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1724360510; x=1724965310; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=4WqrKHoNN6SjkjPYFy7n6FJQkGhUWmO5ciU/UFMkdO8=; b=duCBRW0LSp0mUofk4MWvi7dVnCsMkGfmdIiSopCy5Buh5K1GaWvhS7D6M3XrcNmhtQ kQ6clMJqGvTDb42uqnqkE4aj8BIUu2tPQzcTe2eRBjpjtsGl7E6O5bNbx2rekujoXBAC j3J1fDSG+94BEsgZVkVWdP/Isoryc1ixHM2YpHAiEUotDjvBwws6NCcBTof/xHRbS33O Z0SDSubVXDiCbLEqkvrpx2Wdnmv+IsrVeKd8xI+jqWHl/dFX5pMOsC20sMacGSiHO8ll korHUExNEEpzELlZ/btXNMEARFT3VK0j4d8EYzVASYUpmqd5NSd1rZzyJHwppuhRMJUO /u+A== X-Gm-Message-State: AOJu0YyIP80AoP1Jbjh7qxj2vETpAuLKJCw6A8AOp3wHTuA3vP86SSo1 sqz0yWKLw63l0kReP9neQZlv/MmARVgsEEKqEo6kT1xeYy8/4quEMPDNhzvQBvEKvcEJIov6QzA WIf0ZAh6iy/sjKf6EZE1T9te2FZM1gO8VHbsc X-Google-Smtp-Source: AGHT+IGrIcTqEwPiAwIgVxSsuYoezWvzX0przfQ20g9eqVVyYfYDY82RLXff1FclVK3AFBUP5qn6vpMir60WP1PBr9s= X-Received: by 2002:a05:6512:ac4:b0:533:43bf:565d with SMTP id 2adb3069b0e04-53438785332mr77793e87.27.1724360509452; Thu, 22 Aug 2024 14:01:49 -0700 (PDT) In-Reply-To: <86wmk8qsgs.fsf@gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:290563 Archived-At: --000000000000a192f806204bf79e Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi Eli, Thanks for looking at that further. Re: the second issue, the problem seems to start here, with this: element (see PROBLEM below), which (a) seems out of place (b) is never closed w/ "
, 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 "" seems to be closed with a mismatched ""

Syntax checks happen “on-the-fly”. Each check is started whenever:

<=3D=3D PROBLEM?
  • flymake-mode is started, unless flymake-start-on-flymake-mode is nil;
  • the buffer is saved, unless flymake-start-on-save-buffer is nil;
  • some changes were made to the buffer more than 0.5 seconds ago (the delay is configurable in flymake-no-changes-timeout).
  • When the user invokes the command flymake-start.
    • <=3D=3D PROBLEM?

    If the check detected errors or warnings, the respective buffer regions are highlighted. See Finding diagnostics, for how to learn what the problems are.

    I am unfamiliar w/ Texinfo, but I nonetheless don't see any "obvious" reason that a
    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=3D= 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=E2=80=AFPM Eli Zaretskii wrote: > > From: Lester Longley > > 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: > > > > href=3D"../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! > --000000000000a192f806204bf79e Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

    =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 <p>Syntax checks happen &ldquo;on-the-fly&r= dquo;.=C2=A0 Each check is started whenever:
    =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0 </p>

    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 <tab= le style=3D"float:left" width=3D"100%">=C2=A0 <= =3D=3D PROBLEM?
    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 <li> <= ;code>flymake-mode</code> is started, unless
    =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 <code>flymake-start-on-flymake-mode&l= t;/code> is <code>nil</code>;

    =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 </li><li> the buffer is saved, unless <= code>flymake-start-on-save-buffer</code> is
    =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0<code>nil</cod= e>;

    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0</li><li> some changes were made to the buffer more than <= ;code>0.5</code> seconds ago
    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0(the dela= y is configurable in <code>flymake-no-changes-timeout</code>).<= br>
    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 </li><li> When the user invokes the command <code= >flymake-start</code>.
    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0</li></= ul>=C2=A0 <=3D=3D PROBLEM?

    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 <p>If the check detected errors or warnings, the respective bu= ffer
    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0regions are = highlighted.=C2=A0 See <a href=3D"#Finding-diagnostics">Fin= ding diagnostics</a>, for how to
    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0learn what the problems are.
    =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0 =C2=A0 </p>

    I am unfam= iliar w/ Texinfo, but I nonetheless don't see any "obvious" r= eason that a <table> element should be emitted at the above location,= based on the below excerpt from=C2=A0https://git= .savannah.gnu.org/cgit/emacs.git/tree/doc/misc/flymake.texi?h=3Demacs-29#n1= 15 (I'm just guessing on the corresponding version of this file cur= rently used for the online documentation)

    =C2=A0 = =C2=A0 Syntax checks happen ``on-the-fly''.=C2=A0 Each check is sta= rted whenever:

    =C2=A0 =C2=A0 @itemize @bullet
    =C2=A0 =C2=A0 @item=
    =C2=A0 =C2=A0 @code{flymake-mode} is started, unless
    =C2=A0 =C2=A0 @= code{flymake-start-on-flymake-mode} is @code{nil};

    =C2=A0 =C2=A0 @it= em
    =C2=A0 =C2=A0 the buffer is saved, unless @code{flymake-start-on-save= -buffer} is
    =C2=A0 =C2=A0 @code{nil};

    =C2=A0 =C2=A0 @item
    =C2= =A0 =C2=A0 some changes were made to the buffer more than @code{0.5} second= s ago
    =C2=A0 =C2=A0 (the delay is configurable in @code{flymake-no-chang= es-timeout}).

    =C2=A0 =C2=A0 @item
    =C2=A0 =C2=A0 When the user inv= okes the command @code{flymake-start}.
    =C2=A0 =C2=A0 @end itemize

    Perhaps this is helpful; if not please pardon & = ignore.

    On Thu, Aug 22, 2024 at 3:16=E2=80=AFPM Eli Zaretskii <eliz@gnu.org> wrote:
    > From: Lester Longley <lester@ieee.org>
    > Date: Thu, 22 Aug 2024 15:07:57 -0400
    > Cc: 72761@d= ebbugs.gnu.org
    >
    > OK, here's a clue re: the first issue.
    >
    > The flymake "nodes" ( htt= ps://www.gnu.org/software/emacs/manual/html_node/flymake/ ) manual (att= empts) to
    > make a relative "cross link" to the eglot "nodes" = manual, like so:
    >
    >=C2=A0 =C2=A0 =C2=A0<a data-manual=3D"eglot" href=3D"= ../eglot_html/Eglot-Features.html#Eglot-Features">Eglot Features<= ;/a>

    Yes, that part was evident.=C2=A0 The question was why it says
    "eglot_html".=C2=A0 And I just found the answer: it's a relat= ively recent
    change in Texinfo.=C2=A0 From the Texinfo NEWS file:

    =C2=A0 7.0 (7 November 2022)
    =C2=A0 * texi2any
    =C2=A0 [...]
    =C2=A0 =C2=A0. HTML output:
    =C2=A0 =C2=A0 =C2=A0 =C2=A0. use manual_name_html as output directory for s= plit HTML instead of
    =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0manual_name or manual_name.html

    Ugh!
    --000000000000a192f806204bf79e--