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

[Patrice Dumas]

On Sat, Jul 21, 2012 at 12:18:16PM -0700, Per Bothner wrote:
> 
> See the attached kawa.texi.
> 
> However, I'm not sure it matters, at least from my point of view.

The HTML output looks correct to me.

> The resulting link in the pdf is pretty ugly:
> 
>   field-or-method-decl ::= [field-decl], page 2 | method-decl

I see.  I don't think there is a way to prevent pages from being output
in TeX cross refs.

> I would rather have just:
> 
>   field-or-method-decl ::= field-decl | method-decl
> 
> even at the cost of not having the cross reference (as long as
> "field-decl" appears in the index).
> 
> So for Kawa it seems better to use a conditional to create just
> the raw text with the cross-reference, as I do for info.

That looks awfully format specific.  I think that the Info specifics
are not that an issue, but a no tex conditional, that's quite 
annoying.  For that reason, keeping a warning may be the best thing to
do for now.

-- 
Pat