GNU bug report logs - #8398
24.0.50; info-mode adding spurious "see" to @ref links

Previous Next

Full log

Message #8 received at 8398 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Jason Earl <jearl <at> notengoamigos.org>
Cc: 8398 <at> debbugs.gnu.org
Subject: Re: bug#8398: 24.0.50; info-mode adding spurious "see" to @ref links
Date: Thu, 31 Mar 2011 20:25:43 -0400

Jason Earl wrote:

> For more information on info itself you can read
> @iftex
> @cite{Info: An Introduction}.
> @end iftex
> @ifnottex
> @ref{Top, , Info, info, Info: An Introduction}.
> @end ifnottex
>
> The info file produced, and it looked fine in the info client.
>
>    For more information on info itself you can read *note Info:
> (info)Top.
>
> However, in Emacs' info-mode it looks like this:
>
>    For more information on info itself you can read *note Info:
> (info)Top.
>
> Essentially it replaced the *note with the word "see" which makes the
> sentence read funny.

I think you mis-typed your second example...

The behaviour is customizable through Info-hide-note-references.

The elisp intro does not say "you can read", so looks OK IMO:

   This introduction to `Programming in Emacs Lisp' has a companion
document, see The GNU Emacs Lisp Reference Manual.

Personally I think your "you can read @ref" is not really Texinfo style (?),
which is why the result looks a bit odd.

http://www.gnu.org/s/hello/manual/texinfo/ref.html

Previous Next

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