Re: RE: [PHP4BETA] Coding und documentation standards

"Stig S. Bakken" wrote: > I've sort of settled with Javadoc for now. I tried doing XML, but it > was simply too verbose and clutters up the code/comments too much. But > we definitely need a good solution for this in PHP 4 / PEAR. The > solutions I have had in mind are: > > 1. Javadoc with plain text. > > 2. Javadoc with HTML or XHTML (XML HTML rather than SGML HTML) > formatting. The [X]HTML markup would then be translated to DocBook for > use in manuals. I'd like to see php as close to Javadoc as possible, because the format has become very famous. Many C++ coders and the KDE team are using the Javadoc. Javadoc wouldn't be enough for php coders. For example php does nopt know access modifiers, nevertheless each method if a php class is intended to be used in a certain way. Therefor I prefer [2]. I'll think of a DTD and write again when there's a first attempt. Ulf -- Suche 17'' Monitor, 1024x768 ordentlich, Kiel