This is the mail archive of the
gdb@sourceware.org
mailing list for the GDB project.
Re: A new strategy for internals documentation
- From: Steinar Bang <sb at dod dot no>
- To: gdb at sourceware dot org
- Date: Wed, 21 Aug 2013 20:09:18 +0200
- Subject: Re: A new strategy for internals documentation
- References: <5201781A dot 3000607 at earthlink dot net> <83k3jyunt8 dot fsf at gnu dot org> <5202A6D6 dot 8090908 at earthlink dot net>
>>>>> Stan Shebs <stanshebs@earthlink.net>:
>>> *** Doxygen
>>> As a second step, we should adopt Doxygen for the sources, and use it
>>> to generate material for a new area of the website, which will be the
>>> detailed documentation of GDB internals.
>> AFAIK, Doxygen cannot generate an Info manual, only HTML. If so, this
>> would be a serious downside that you don't mention.
> Hmm, I'm perhaps prejudiced since I haven't looked at any info file in
> probably a decade. Are many people using them still?
Doxygen can generate output in Docbook XML. A quick google found me
this tool that can convert Docbook to texinfo:
http://docbook2x.sourceforge.net/
How well that works I have no idea.
The Docbook output can be converted to a printable manual, and so can
Doxygen's LaTeX output.