Re: Re: From the PHP Forum Paris
| From: | Bertrand Mansion | Date: | Mon, 09 Dec 2002 22:39:51 +0000 |
| Subject: | Re: Re: From the PHP Forum Paris | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-11473@lists.php.net to get a copy of this message | ||
<greg@chiaraquartet.net> wrote :
>
> "Bertrand Mansion" <bmansion@mamasam.com> wrote in message
> news:BA1AA734.37E6%bmansion@mamasam.com...
>> Hi,
>>
>> I have been to the first session of the PHP Forum in Paris today. All in
>> all, it has been an interesting day. I have noted two things that might be
>> of interest:
>>
>> 1. Zend Studio can create inline documentation that is not completely
>> compatible with current php doc parsers because of a @desc tag (instead of
>> no tag currently). It would be nice to add this option to current php doc
>> parsers.
>
> phpDocumentor in the cvs supports this tag. The problem with Zend Studio is
> that none of the tags are standard, so the @param tag will not work, and
> there was one other that I can't remember which was formatted differently..
> People who wish to use the Zend Studio format will be stuck with the Zend
> Studio output for small details, but @desc will be (grudgingly) supported..
Well, I have the feeling that Zend will modify the way inline doc is
presented in a future version. IMO, it's important for them to keep up with
standards for their product to spread. Unless they plan to create a
proprietary documentation tool but that's probably not the case.
Bertrand Mansion
Mamasam