[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
@anchor on @item line (was: emacs-29 889a550ca08: ; Fix Texinfo warnings
From: |
Ihor Radchenko |
Subject: |
@anchor on @item line (was: emacs-29 889a550ca08: ; Fix Texinfo warnings) |
Date: |
Sun, 05 Nov 2023 11:30:42 +0000 |
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>
- @anchor on @item line (was: emacs-29 889a550ca08: ; Fix Texinfo warnings),
Ihor Radchenko <=