Re: [PHP4BETA] Re: [PHP-PEAR] PEAR javadoc-style docs
| From: | Egon Schmid | Date: | Thu, 11 May 2000 09:07:01 +0000 |
| Subject: | Re: [PHP4BETA] Re: [PHP-PEAR] PEAR javadoc-style docs | ||
| References: | 1 2 | Groups: | php.pear php.version4 |
| Request: | Send a blank email to php-pear+get-96@lists.php.net to get a copy of this message | ||
Ulf Wendel wrote:
>
> Joey wrote:
>
> > On general principle, I have to cast my vote with Egon.
> >
> > Documentation for a project as big as PHP is worth doing in a well
> > structured manner, and XML is the most powerful way to structure data.
>
> I'm afraid you misunderstood me as well. I'm not talking about the php
> manual, I'am talking about inline documentation in php scripts such as
> PEAR. Inline documentation in a php script can be extracted to build a
> quick reference.
I mean "Documentation and Folding Hooks" in CODING_STANDARDS. This is
PHPs inline documentation. If you look into Rasmus Pocket Reference or
into the German Markt&Technik Book you can see the quick reference. In
the German book it is called Funktionskurzreferenz.
-Egon
--
SIX Offene Systeme GmbH · Stuttgart - Berlin - New York
Sielminger Straße 63 · D-70771 Leinfelden-Echterdingen
Fon +49 711 9909164 · Fax +49 711 9909199 http://www.six.de