@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>