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

[Ihor Radchenko <yantar92@posteo.net>]

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>