Re: warning: @ref should not appear in @deffn

[Patrice Dumas]

On Sun, Jul 22, 2012 at 06:55:51PM +0000, Karl Berry wrote:
>     I don't think there is a way to prevent pages from being output
>     in TeX cross refs.
> 
> Right now, that is true, though it would be simple to conditionally omit
> it.  The hard part is figuring out the document-level interface.  No
> ideas are springing to mind.
> 
> It would also introduce a difference between DVI and PDF, I guess, since
> only PDF has the whole concept of "link" and so in DVI we'd end up with
> a cross-reference that doesn't have any actual cross-reference
> information, which seems pretty pointless.

I agree, and even in PDF, once the document is printed, the link has to
be a page.


I thought a bit about the whole issue of cross-references in code like
environments, like @code, @def*, @example...  In all those environments,
the text should be kept as is, so refs will look good only in outputs
where there is a link (html, pdf) distinct from the text itseelf.  This 
could be a possible criteria, when in code-like environments, omit the 
page number and use the text only.  But it may also break user 
expectations sinceit would mean a no-op in many formats, such as dvi,
Info.

-- 
Pat