@anchor on @item line (was: emacs-29 889a550ca08: ; Fix Texinfo warnings)

Ihor Radchenko <[email protected]>
Newsgroups gmane.emacs.devel,gmane.comp.tex.texinfo.general
Message-ID <87msvs5tel.fsf@localhost>
Hi,

This is a question regarding a recent change in Texinfo.

AFAIU, @anchor in Texinfo can be used to refer to arbitrary place in the
document: https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#g_t_0040anchor
In some scenarios, this "arbitrary place" can be located _inside_ an
item.

However, there is a warning being produced when @anchor is found on the
same line with an item:

org.texi:15975: warning: @anchor should not appear on @item line

The problematic .texi source is

    @table @asis
    @item @samp{OrgOdtStyles.xml} @anchor{x-orgodtstyles-xml}
    This file contributes to the @samp{styles.xml} file of the final ODT
    document.  This file gets modified for the following purposes:

Here, the @anchor is referring to OrgOdtStyles.xml file and is not
necessarily linked to the @item itself.

May someone please explain the correct usage of @anchor in the above
example and why the warning is being thrown?

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.