From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.bugs Subject: bug#69811: 30.0.50; Texinfo warning: @anchor/@footnote on @item line Date: Fri, 15 Mar 2024 10:28:35 +0100 Message-ID: <87il1nsv24.fsf@epfl.ch> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19811"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) To: 69811@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Mar 15 10:29:47 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 1rl3sp-0004wP-J8 for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 15 Mar 2024 10:29:47 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rl3sX-0008Ar-Qr; Fri, 15 Mar 2024 05:29:29 -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 1rl3sU-0008AF-Pe for bug-gnu-emacs@gnu.org; Fri, 15 Mar 2024 05:29:26 -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 1rl3sU-00037t-HV for bug-gnu-emacs@gnu.org; Fri, 15 Mar 2024 05:29:26 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rl3t4-0003Ei-NQ for bug-gnu-emacs@gnu.org; Fri, 15 Mar 2024 05:30:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 15 Mar 2024 09:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 69811 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.171049497112374 (code B ref -1); Fri, 15 Mar 2024 09:30:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 15 Mar 2024 09:29:31 +0000 Original-Received: from localhost ([127.0.0.1]:52057 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rl3sZ-0003DW-2j for submit@debbugs.gnu.org; Fri, 15 Mar 2024 05:29:31 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:55442) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rl3sU-0003DK-SD for submit@debbugs.gnu.org; Fri, 15 Mar 2024 05:29:29 -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 1rl3rr-0007hK-1E for bug-gnu-emacs@gnu.org; Fri, 15 Mar 2024 05:28:47 -0400 Original-Received: from mail-ed1-f41.google.com ([209.85.208.41]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rl3rk-00033W-6g for bug-gnu-emacs@gnu.org; Fri, 15 Mar 2024 05:28:46 -0400 Original-Received: by mail-ed1-f41.google.com with SMTP id 4fb4d7f45d1cf-56893b3788cso727527a12.0 for ; Fri, 15 Mar 2024 02:28:39 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710494917; x=1711099717; h=mime-version:user-agent:message-id:date:subject:to:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=k8Pisa0wLE60WmR4hSOUoj3Rhe0deq6O7YNxQx9HZBA=; b=MC0CQGo88f2+jfn2xdMRqWvMD27Z2dDqSInLxX3njGZlpoozC85FhVVt+GLrEpfA6a 01ds5EvTm8n+U9iMSb5OsdA8EqERyrleo5aR/S1v1+M+zIsrYaC72JSWOzcLOEElKfjF asror2+qKJp9y30EDUVipCyxj38ctHjofHHGAJjzSawzSFZ1u6KVLUmrFZXdSGkFhQA5 04n1DllRb7VO6wnu8v24q6lkgSgMlCHrmrIyrVKHM9KEri6R+MUNVTUngBDT36cvPgy6 XJAYMLqp7n3nujCQWJ3+hX1Rx+V0e782tyBRVZmWIIVGh56lYkAou5GbYj+9omkWr3uD DIoA== X-Gm-Message-State: AOJu0YzJH0U5IAUsi6JzcSh2k/jHn0Ya9xTivt3JGENRdMPpgpvXPK/6 0xy7PgaolPR94BMBwUSyg7DsDLKBX0UXrcRlTyjIqpXT+8cEFNEfQXu1EGiXPcA= X-Google-Smtp-Source: AGHT+IGfARnYxETkrWVHXpalcBXWSreEw7o4ucu4tWPnjvJsVgWnZRZpt8sJ/VEoW5C/EwjEOZ+y6w== X-Received: by 2002:a05:6402:3888:b0:568:b42f:31ff with SMTP id fd8-20020a056402388800b00568b42f31ffmr514142edb.0.1710494916693; Fri, 15 Mar 2024 02:28:36 -0700 (PDT) Original-Received: from localhost ([2001:620:618:5c0:2:80b3:0:e5c]) by smtp.gmail.com with ESMTPSA id w5-20020a05640234c500b00568802f01f2sm1500272edc.31.2024.03.15.02.28.35 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Mar 2024 02:28:36 -0700 (PDT) Received-SPF: pass client-ip=209.85.208.41; envelope-from=basil.conto@gmail.com; helo=mail-ed1-f41.google.com X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.001, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.248, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action 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:281656 Archived-At: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Severity: minor I think it's since upgrading to the following Texinfo version: $ makeinfo --version texi2any (GNU texinfo) 7.1 that I've been seeing the following warnings when building misc manuals: cc-mode.texi:838: warning: @footnote should not appear on @item line cc-mode.texi:1224: warning: @footnote should not appear on @item line cc-mode.texi:1229: warning: @footnote should not appear on @item line cc-mode.texi:1572: warning: @footnote should not appear on @item line org.texi:15658: warning: @anchor should not appear on @item line org.texi:15671: warning: @anchor should not appear on @item line Is this a Texinfo bug, or am I / are we doing something wrong? I'm confused because: 0. No warnings appear for cc-mode.texi lines 2336 and 2347. 1. "(texinfo) Footnote Commands" says: Footnotes cannot be nested, and cannot appear in section headings of any kind or other "unusual" places. A final tip: footnotes in the argument of an =E2=80=98@item=E2=80= =99 command for an =E2=80=98@table=E2=80=99 must be entirely on the same line as the =E2= =80=98@item=E2=80=99 (as usual). 2. "(texinfo) @table" says: You may write as many lines of supporting text as you wish, even several paragraphs. B= ut only the text on the same line as the =E2=80=98@item=E2=80=99 will be = placed in the first column (including any footnotes). 3. "(texinfo) Command Contexts" says: =E2=80=98@c=E2=80=99, =E2=80=98@comment=E2=80=99 and =E2=80=98@if .= .. @end if=E2=80=99 conditional commands may appear anywhere (except the conditionals must still be on lines by themselves). =E2=80=98@caption=E2=80=99 and =E2=80=98@shortcaption=E2= =80=99 may only appear in =E2=80=98@float=E2=80=99 but may contain general text. =E2=80=98@footnote=E2=80=99 content lik= ewise. In addition to the above, sectioning commands cannot contain =E2=80=98@anchor=E2=80=99, =E2=80=98@footnote=E2=80=99 or =E2=80=98@ve= rb=E2=80=99. 4. "(texinfo) @anchor" says: It is best to put =E2=80=98@anchor=E2=80=99 commands just before th= e position you wish to refer to; that way, the reader's eye is led on to the correct text when they jump to the anchor. My reading of 1-3 is that @footnote is supported, or at least not disallowed, on an @item line. Based on 4, I tried the following change: --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=target.diff diff --git a/doc/misc/org.org b/doc/misc/org.org index 05ab5b36ca0..f925edd4cfe 100644 --- a/doc/misc/org.org +++ b/doc/misc/org.org @@ -14936,7 +14936,7 @@ The ODT exporter relies on two files for generating its output. These files are bundled with the distribution under the directory pointed to by the variable ~org-odt-styles-dir~. The two files are: -- =OrgOdtStyles.xml= <> :: +- <> =OrgOdtStyles.xml= :: This file contributes to the =styles.xml= file of the final ODT document. This file gets modified for the following purposes: --=-=-= Content-Type: text/plain as well as the following: --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=markup.diff diff --git a/doc/misc/org.org b/doc/misc/org.org index 05ab5b36ca0..f35ab400276 100644 --- a/doc/misc/org.org +++ b/doc/misc/org.org @@ -14936,7 +14936,7 @@ The ODT exporter relies on two files for generating its output. These files are bundled with the distribution under the directory pointed to by the variable ~org-odt-styles-dir~. The two files are: -- =OrgOdtStyles.xml= <> :: +- <> OrgOdtStyles.xml :: This file contributes to the =styles.xml= file of the final ODT document. This file gets modified for the following purposes: --=-=-= Content-Type: text/plain but the warnings are still emitted. Thoughts? Does anyone else see these warnings? Thanks, -- Basil In GNU Emacs 30.0.50 (build 1, x86_64-pc-linux-gnu, X toolkit, cairo version 1.18.0, Xaw3d scroll bars) of 2024-03-15 built on tia Repository revision: 09ab66935154ea0cc4a351b8320bc0e9276b7780 Repository branch: master Windowing system distributor 'The X.Org Foundation', version 11.0.12101011 System Description: Debian GNU/Linux trixie/sid Configured using: 'configure 'CFLAGS=-Og -ggdb3' -C --prefix=/home/blc/.local --enable-checking=structs --without-native-compilation --with-file-notification=yes --with-x-toolkit=lucid --with-x' Configured features: ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GPM GSETTINGS HARFBUZZ JPEG JSON LCMS2 LIBOTF LIBSELINUX LIBSYSTEMD LIBXML2 M17N_FLT MODULES NOTIFY INOTIFY PDUMPER PNG RSVG SECCOMP SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS TREE_SITTER WEBP X11 XAW3D XDBE XIM XINPUT2 XPM LUCID ZLIB Important settings: value of $LANG: en_IE.UTF-8 value of $XMODIFIERS: @im=ibus locale-coding-system: utf-8-unix Major mode: Lisp Interaction Minor modes in effect: tooltip-mode: t global-eldoc-mode: t eldoc-mode: t show-paren-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t minibuffer-regexp-mode: t line-number-mode: t indent-tabs-mode: t transient-mark-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t Load-path shadows: None found. Features: (shadow sort mail-extr emacsbug message mailcap yank-media puny dired dired-loaddefs rfc822 mml mml-sec password-cache epa derived epg rfc6068 epg-config gnus-util text-property-search time-date subr-x mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader cl-loaddefs cl-lib sendmail rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mail-utils rmc iso-transl tooltip cconv eldoc paren electric uniquify ediff-hook vc-hooks lisp-float-type elisp-mode mwheel term/x-win x-win term/common-win x-dnd touch-screen tool-bar dnd fontset image regexp-opt fringe tabulated-list replace newcomment text-mode lisp-mode prog-mode register page tab-bar menu-bar rfn-eshadow isearch easymenu timer select scroll-bar mouse jit-lock font-lock syntax font-core term/tty-colors frame minibuffer nadvice seq simple cl-generic indonesian philippine cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese composite emoji-zwj charscript charprop case-table epa-hook jka-cmpr-hook help abbrev obarray oclosure cl-preloaded button loaddefs theme-loaddefs faces cus-face macroexp files window text-properties overlay sha1 md5 base64 format env code-pages mule custom widget keymap hashtable-print-readable backquote threads dbusbind inotify lcms2 dynamic-setting system-font-setting font-render-setting cairo x-toolkit xinput2 x multi-tty move-toolbar make-network-process emacs) Memory information: ((conses 16 39481 8902) (symbols 48 5219 0) (strings 32 13384 2364) (string-bytes 1 314118) (vectors 16 9310) (vector-slots 8 110984 8170) (floats 8 23 25) (intervals 56 266 0) (buffers 984 10)) --=-=-=--