Re: Re: pear/PHPDoc status
| From: | Stig S. Bakken | Date: | Sun, 15 Jul 2001 14:22:46 +0000 |
| Subject: | Re: Re: pear/PHPDoc status | ||
| References: | 1 2 3 | Groups: | php.pear.general |
| Request: | Send a blank email to pear-general+get-197@lists.php.net to get a copy of this message | ||
Hi Joshua,
Have you spoken to Ulf Wendel about your project? I would like to see
efforts joined into one project that lets us automate doc. generation
for pear.php.net. There is a lot of pear docs written that never reach
their audience because they sit tight in their docblocks...
- Stig
Joshua Eichorn wrote:
>
> I've also been working on a PHPDoc documentation tool. It might suit
> your needs better. It currently has some rought edges also, but
> I am actively developing it, and will continue to since i rely on it to
> document projects through my work.
>
> If anyone wants to take a look the website is phpdocu.sourceforge.net.
> I have no problems including it in PEAR or moving it to any locations
> cvs. However i wasn't going to bring that up until i get it to a stage
> where i feel it is mainly feature complete.
> -joshua eichorn
>
> btw: i have contacted the author of phpdoc previously and tried hacking
> on his code, but i found the code i had already created more useful
> for my needs.
>
> Sebastian Bergmann wrote:
>
> >skelly@juptech.com wrote:
> >
> >>I noticed that you recently removed the pear/PHPDoc tree from CVS.
> >>
> >
> > I did not remove, but move it: into PEAR's own CVS module.
> >
> >>Does this represent the demise of PHPDoc as far as PHP distributions
> >>are concerned?
> >>
> >
> > Yes, PHPDoc will be no longer in the distributions.
> >
> >>Even though it has a few rough edges and development seems to have
> >>stalled, I found it kind of useful. Is there a preferred
> >>documentation extraction method to use (I find phpdoc => javadoc
> >>to be a bit limiting when it comes to PHP language elements).
> >>
> >
> > PHPDoc remains the 'official' source documentation tool for PHP.
> >
> > Yours,
> >Sebastian
> >