From: Gavin Smith <gavinsmith0123@gmail.com>
To: Patrice Dumas <pertusus@free.fr>,
Ihor Radchenko <yantar92@posteo.net>,
Eli Zaretskii <eliz@gnu.org>,
help-texinfo@gnu.org, arash@gnu.org, emacs-devel@gnu.org
Subject: Re: @anchor on @item line
Date: Tue, 14 Nov 2023 21:58:01 +0000 [thread overview]
Message-ID: <ZVPtaa7aqzg016dR@beigestar> (raw)
In-Reply-To: <ZVEmPAUAomcDvuEq@beigestar>
On Sun, Nov 12, 2023 at 07:23:41PM +0000, Gavin Smith wrote:
> There is actually a problem with @ftable and @vtable. If you put an
> @anchor on an @item line there, then it is the text of an index entry,
> which is a real problem.
Further to this, if @anchor should be allowed inside @item as long as the
@item is not creaing an index entry, it should also be allowed inside
@defline and @deftypeline (these are new commands), as these do not create
index entries.
I have made a commit today to allow @anchor in @item and also these
other commands, and will also add this change to the release branch so
that if there is ever a 7.1.1 release, this fix will be included.
We may still not want to allow other "non-basic inline" commands
(e.g. @xref) inside @item/@defline/@deftypeline as inappropriate for
one reason or another, but at the moment it seems the easiest way forward
is to allow these.
@anchor used inside @item inside @ftable/@vtable still leads to a warning
if the index is output, just the warning is slightly obscure.
I thought of allowing @anchor as basic inline content, but we would have
to come up with some other mechanism for detecting and warning about
@anchor inside index entries, and there are too many other commands where
we truly should not have @anchors (e.g. @node names, as cross-references
to those nodes would have to have the @anchor in them). @anchor should
not appear in any context where it does not correspond to a single
position in the output file.
next prev parent reply other threads:[~2023-11-14 21:58 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
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 [this message]
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
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=ZVPtaa7aqzg016dR@beigestar \
--to=gavinsmith0123@gmail.com \
--cc=arash@gnu.org \
--cc=eliz@gnu.org \
--cc=emacs-devel@gnu.org \
--cc=help-texinfo@gnu.org \
--cc=pertusus@free.fr \
--cc=yantar92@posteo.net \
/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 public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).