This is the mail archive of the
gdb-patches@sourceware.cygnus.com
mailing list for the GDB project.
Re: RFA: Document RETURN_VALUE_ON_STACK
> > I think we should be using @deftypefn for everything; that will build
> > a function index for us automatically. No?
>
> If that's what people prefer, I don't mind.
>
> Personally, I dislike the @defXXX commands, because they violate the
> Texinfo language rules (e.g., use unescaped braces). Their handling
> in makeinfo is a horrible kludge which has subtle problems and
> idiosyncrasies.
Well, they generally work okay for me. The aesthetics don't really
bother me, and I like the automatic indexing, and the formatting they
do. The way people have handled the existing entries is evidence that
the alternative (doing it by hand) is less than appealing.
I happily leave the decision to the maintainers, but I vote for the
@def functions. If you decide in favor of it, I'll put my money where
my mouth is and do the conversion.