[dev] Source-level documentation

[Jan Schneider]

Zitat von Jon Parise <jon@horde.org>:

> Out of the lot, I think the phpdoc version is the least useful, the
> DHTML version is the prettiest, and the Doxygen version has the most
> potential.

The DHTML is indeed the prettiest but a pain to update and buggy too.
 
> I'm slightly biased because I use Doxygen for so many other projects
> right now, but I think it may be preferrable to start using
> Doxygen-style tags instead of phpdoc.
> 
> My reasoning:

Sounds reasonable.
 
>  -  Doxygen supports more output formats; in addition to HTML, it can
>     generate: XML, LaTeX, RTF, PDF, Windows Help format

Great.
 
> Anyway, that's my little mini-sermon on why I think Doxygen is neat
> and of use to the project.  I've been hearing talk about phpdoc being
> rewritten / updated / improved for almost two years now, and I have
> yet to see anything exciting come of it.

I was hoping on some work being done on phpdoc since the last discussions
but you're right: Nothing seem to happen to make more stable/feature rich.

Conclusion: +1 for switching to Doxygen.

Jan.

--
http://www.horde.org - The Horde Project
http://www.ammma.de - discover your knowledge
http://www.tip4all.de - Deine private Tippgemeinschaft