[openbeos] Re: doxygen basics
- From: "John Gabriele" <jandl@xxxxxxxxxxx>
- To: openbeos@xxxxxxxxxxxxx
- Date: Thu, 13 Dec 2001 22:02:22 EST
Erik wrote:
>
> I'm really torn on this subject,
> [snip]
> I *hate* it's output. And I do mean *hate*.
> [snip]
> The doxygen output that I've seen thus far doesn't even come close to
> that kind of readability, and I feel very strongly that documentation of
> public APIs should be *extremely* friendly (wouldn't hurt for private
> APIs, either). After all, it was reading Be's online docs for R3 that
> convinced me that I just *had* to develop for BeOS.
> [snip]
> There are other
> freely available (and open source) doc generation tools out there that
> use JavaDoc-like commenting, and if doxygen can't be made to behave,
> perhaps one of those other tools can. ;)
Then Jean commented:
> I wholeheartidly agree. I like the doxygen concept but hate the output.
> If we output the default way I think I'd rather read the doc right from
> the source code files than through doxygen.
Does anyone know of (and can point everyone else to) some alternatives
to doxygen?
Other related posts:
