Re: [phplib-dev] classdoctpl.pl and Coding Style ? From: Ulf Wendel (UW <email protected>)
Date: 05/23/00

Holger Blasum wrote:
> Q3: I remember that on this list recently there was a discussion on the pros and cons of inline > documentation (though I have not kept the mail and am unable to loacte this at the MARC or NETUSE
> archives apparently both ending on 26 Apr). Have any suggestions or even agreements on usage or format > of inline documentation (which would allow more efficient parsing of such documentation) evolved from > this?

There's no final decision on this topic. I personally preferr
inline documentation and I'm working on adopting Javadoc for PHP.
It won't take long until you'll see me anouncing PHPDOC1.0alpha
and sending it to the PEAR guys. One fine day it might get a PEAR
standard and I guess PHPLIB will follow PEAR suggestions.

Up to this point you should write documentation in the way it is
done now. Coding rules? Well, look at the core functionality and
follow that style.

Ulf 

-- 
Ulf Wendel
NetUSE Kommunikationstechnologie GmbH
Siemenswall, D-24107 Kiel, Germany
Fon: +49 431 386435 00  --  Fax: +49 431 386435 99

---------------------------------------------------------------------
To unsubscribe, e-mail: phplib-dev-unsubscribe <email protected>
For additional commands, e-mail: phplib-dev-help <email protected>