This is the mail archive of the gdb-patches@sourceware.cygnus.com mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

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.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]