Re: javadoc, phpdoc, XML, and PEAR

Quoting Joey <joey@samaritan.com>: > Actually, the real problem is that I am not very good at > communcation. :) > I really think that the current system of inline documentation > as it is being used in php source is as easy to learn as javadoc, > and don't see any reason why people just don't use it for PEAR as > well. The XML idea is, as I said, something my friend and I are > throwing around...read my response to Stig about inlining XML. Right, I saw that - looked nice, but far too complicated. And you don't want to require developers to use a single tool to write their code in. Also, while the current system may be easy to use, the inline part of it doesn't provide (to my knowledge) for author, version, specific parameter information... etc. Just a name, maybe signature, and one-line description. Javadoc is much more expressive. -chuck