This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: Undocumented source files
On Fri, Nov 22, 2002 at 09:29:05PM +0000, Joseph S. Myers wrote:
> On Fri, 22 Nov 2002, Phil Edwards wrote:
>
> > *cough*doxygen*cough*
>
> Will it generate Texinfo (to go in the overall internals manual)?
Of course not. Very few projects use Texinfo.
Since nobody reads the texinfo files -- they only read the result of some
texinfo->foo conversion -- you only need some format that can also produce
the foo format.
In the latest version, Doxygen produces HTML and LaTeX, which should cover
most of the output worries. The "info" format would be a horrible format
anyhow for the kind of thing that we typically want out of doxygen.
Phil
--
I would therefore like to posit that computing's central challenge, viz. "How
not to make a mess of it," has /not/ been met.
- Edsger Dijkstra, 1930-2002