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

[Per Bothner]

On 07/21/2012 11:18 AM, Patrice Dumas wrote:
> On Sat, Jul 21, 2012 at 10:37:25AM -0700, Per Bothner wrote:
> > > > http://www.gnu.org/software/kawa/Defining-new-classes.html
> > >
> > > The result is indeed interesting.  Does it look good in direct
> > > html/dvi/pdf too?
> >
> > Alas - it looks good - but wrong.
>
> Could you please send a small example that could be used as a test case?

See the attached kawa.texi.

However, I'm not sure it matters, at least from my point of view.
The resulting link in the pdf is pretty ugly:

  field-or-method-decl ::= [field-decl], page 2 | method-decl

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.
--
        --Per Bothner
address@hidden   http://per.bothner.com/

kawa.texi
Description: Text Data