From: Ihor Radchenko <yantar92@posteo.net>
To: Eli Zaretskii <eliz@gnu.org>
Cc: arash@gnu.org, emacs-devel@gnu.org
Subject: Re: emacs-29 889a550ca08: ; Fix Texinfo warnings
Date: Tue, 24 Oct 2023 09:11:08 +0000 [thread overview]
Message-ID: <87v8aw75cj.fsf@localhost> (raw)
In-Reply-To: <838r7to1mu.fsf@gnu.org>
Eli Zaretskii <eliz@gnu.org> writes:
>> I do not see any clear reason why one may not put @anchor at the same
>> line with @item.
>
> I don't understand what you are saying here. Are you saying that the
> warning is bogus and should not be emitted in this case? Or that the
> Texinfo manual should explain better why @anchor should not appear on
> an @item line? If so, please take this up with the Texinfo
> maintainers, and ask them either to change the code or to fix the
> manual.
I was hoping that you know and can quickly explain the reason.
> Me, I would simply move the @anchor line before the @item, where it
> belongs. It will shut up the warning and also make the manual cleaner
> from the Texinfo POV. (Thet's what I did in other cases where this
> warning was emitted by makeinfo 7.1.) But that's me.
Moving _before_ @item is not an option. For example, consider
- This is a long list item, and we want to put an anchor <<<here>>>, in the middle of the line.
The anchor does not belong to item itself, it is linking to a specific
place in the text.
>> In Org mode, we add @anchor at the same place where the corresponding
>> Org markup (<<<radio target>>>) is placed.
>
> That's a mistake, IMO. @anchor is basically the same as @node.
AFAIU, it is not. See the above example.
>> I guess we might try to put @anchor on a separate line just for the sake
>> of avoiding this warning, but I am not confident that it is always safe
>> and won't break Texinfo markup.
>
> It won't, since that's how @anchor is supposed to be used.
Does it mean that something like
@item This is
@anchor{my-anchor}
a single paragraph inside item.
is always safe?
--
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>
next prev parent reply other threads:[~2023-10-24 9:11 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <169796650463.2984.6470791064475342706@vcs2.savannah.gnu.org>
[not found] ` <20231022092145.0486AC09BDB@vcs2.savannah.gnu.org>
2023-10-22 10:30 ` emacs-29 889a550ca08: ; Fix Texinfo warnings Arash Esbati
2023-10-22 11:03 ` Eli Zaretskii
2023-10-23 10:36 ` Arash Esbati
2023-10-23 12:35 ` Ihor Radchenko
2023-10-23 12:44 ` Eli Zaretskii
2023-10-23 13:24 ` Ihor Radchenko
2023-10-23 14:27 ` Eli Zaretskii
2023-10-24 9:11 ` Ihor Radchenko [this message]
2023-10-24 11:48 ` Eli Zaretskii
2023-11-05 11:30 ` @anchor on @item line (was: emacs-29 889a550ca08: ; Fix Texinfo warnings) Ihor Radchenko
2023-11-06 19:29 ` Gavin Smith
2023-11-07 10:29 ` Patrice Dumas
2023-11-12 19:23 ` @anchor on @item line Gavin Smith
2023-11-14 21:58 ` Gavin Smith
2023-11-15 3:30 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87v8aw75cj.fsf@localhost \
--to=yantar92@posteo.net \
--cc=arash@gnu.org \
--cc=eliz@gnu.org \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.