GNU bug report logs - #70382
29.3; Info-fontify-node renders cross-references misleadingly

Previous Next

Package: emacs;

Reported by: matt <at> excalamus.com

Date: Sun, 14 Apr 2024 14:37:03 UTC

Severity: normal

Found in version 29.3

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: 70382 <at> debbugs.gnu.org, matt <at> excalamus.com, juri <at> linkov.net
Subject: bug#70382: 29.3; Info-fontify-node renders cross-references misleadingly
Date: Sun, 14 Apr 2024 22:16:13 +0300
> From: Stefan Monnier <monnier <at> iro.umontreal.ca>
> Cc: matt <at> excalamus.com,  Juri Linkov <juri <at> linkov.net>,  70382 <at> debbugs.gnu.org
> Date: Sun, 14 Apr 2024 14:43:31 -0400
> 
> > I think the only sane way of dealing with this problem is to disable
> > Info-hide-note-references in that particular node (and any other
> > nodes,  if we find them, where there's a similar issue).  The patch
> > below attempts to do that.
> 
> Sounds OK.

OK, I will install this soon, unless Juri (or someone else) comes up
with something more elegant.

> > Juri and Stefan, do you see a cleaner solution?
> 
> We could try and detect that the cross ref is within a '...'.

That would fail in other cases.

> BTW, I'm not sure whether the current behavior is really a problem:
> after all, in Emacs, people indeed won't see something of the form
> `*note NAME: NODE.` but they'll see something of the form `see NAME` or
> `See NAME`, so the bug could be considered a feature (depending on
> whether we think the doc describes the content of the Info file or
> whether it describes when readers will see when reading their doc in
> Emacs).

Yes, but here we make worse mistakes: not only we should "see" with
wrong capitalization, we also make the impression that @ref shows as
"see" in Emacs (it doesn't) and @pxref shows "*note" (it shows "see").

(I think the text should have a note that in Emacs these
cross-references will look differently, but that's a patch to be
submitted to the Texinfo developers.)




This bug report was last modified 1 year and 94 days ago.

Previous Next


GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.