This is the mail archive of the
gdb@sourceware.org
mailing list for the GDB project.
Re: Documentation generated from sources proposal
> From: Jeremy Bennett <jeremy.bennett@embecosm.com>
> Cc: Jan Kratochvil <jan.kratochvil@redhat.com>, gdb@sourceware.org
> Date: Tue, 13 Oct 2009 09:23:37 +0100
>
> One suggestion: gtk-doc is not that general purpose. Doxygen (as
> recommended by the gtk-doc website) might prove a more flexible
> alternative.
>
> The one caveat is that neither of these programs can generate Texinfo,
> so generating .info files will be hard (all the other output formats,
> including man pages can be generated directly, at least by Doxygen). In
> principle it could be done (gtk-doc->docbook->texinfo->info or
> doxygen->XML->texinfo->info), but who knows what the output might end up
> like!
No, the format generated from the comments must be Texinfo.
Can't we use whatever libiberty is using (gather-doc), and format the
comments as it does? Why do we need to switch to such drastically
different tools?