Re: PHPDoc renderer not working

From: 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

« previous php.pear.dev (#5849) next »