Re: PHPDoc renderer not working
| From: | Jesus M. Castagnetto | Date: | Sun, 28 Apr 2002 00:48:14 +0000 |
| Subject: | Re: PHPDoc renderer not working | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-5849@lists.php.net to get a copy of this message | ||
You might want to take a look at phpdocu.sourceforge.net
In (informal) tests running PHPDoc (using the web interface, which works OK
btw), and phpdocu (command line interface). The second one was faster, mainly
because it did not generate intermediate XML files.
When running PHPDoc on pear/Math_Vector (local version, with several
modifications, like addition of unit tests and more examples), I had to stop
the run after 2.5 hours (yes *hours*). In contrast phpdocu took 46 seconds to
produce the documentation.
The second documentation tool, has its quirks, but on the other hand allows
documentation to be associated w/ packages, functions, define(), etc. And seems
to be OK w/ tags like:
@see NameOfOtherClass
which PHPDoc reports as incorrect, even though it is correct according to
JavaDoc specs. I like PHPDoc, it is more complete than phpdocu, but if I have
to wait for hours vs seconds, then guess what will be the tool that I will use
on a day to day basis.
--- Antonio Carlos Venancio Junior <floripa@organiKa.com.br> wrote:
> Tomas,
>
>
> Tim Gallagher (timg@sunflowerroad.com) made that changes and I will
> start to help him next month. I'll make this my college conclusion tesis
> and we are planning to make it stable very soon.
> I've fixed some things and sent to him, but he can't use diff files at
> Windows.
> In my opinion, the front-end part needs to be remade because it's very
> confusing. I'll do that but I don't have time avaiable for the two next
> weeks.
> By the way, what do I have to do to have cvs write access to make
> changes?
>
> On Sat, 2002-04-27 at 00:04, Tomas V.V.Cox wrote:
> > "Jesus M. Castagnetto" wrote:
> > >
> > > I am using the code at pear/PHPDoc/phpdoc (stand alone script), which
> does not
> > > seem to work quite well. Tried putting the appropriate vars in the
> command line
> > > and inside the script, but all I get is the XML files, not the rendered
> HTML
> > > files that are expected. All HTML files contain the number "1" and
> nothing
> > > else; kind of funny to see after a long time of processing a bunch of
> 1-byte
> > > long .html files
> > >
> > > Any ideas? will try and use the index.php file in the same dir.
> > >
> >
> > Someone commited time ago a bounch of changes that seems to cause this.
> > I could try to look at it if someone tells me what had changed (btw I
> > haven't too much time for doing that).
> >
> >
> > Tomas V.V.Cox
> >
> > --
> > PEAR Development Mailing List (http://pear.php.net/)
> > To unsubscribe, visit: http://www.php.net/unsub.php
> >
> >
> --
>
>
> Cya
>
>
> +++
> Antonio CVS .: organiKa :.
> "We use only recicled bits"
> floripa@organiKa.com.br
> http://www.organiKa.com.br
> Key fingerprint = 9F5B 31B0 C52A 4C4D 3A37 3A9F 7304 2779 5BBE B073
>
> ATTACHMENT part 2 application/pgp-signature name=signature.asc
=====
--- Jesus M. Castagnetto (jcastagnetto@yahoo.com)
Research:
http://metallo.scripps.edu/
Personal: http://www.castagnetto.org/
__________________________________________________
Do You Yahoo!?
Yahoo! Health - your guide to health and wellness
http://health.yahoo.com