Re: PHPDoc again

From: Date: Thu, 20 Jun 2002 07:20:52 +0000
Subject: Re: PHPDoc again
Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-7224@lists.php.net to get a copy of this message
Hi, I don't know if you followed the discussion on PHPDocumentor on this list. As far as I understand it, PHPDocumentor will certainly replace PHPDoc and will certainly be used to generate the PEAR doc. Personnaly, I'm still working on the PHPDoc project and I found another one who seems to be interested. As far as I'm concerned, what I want to have in PHPDoc are the following features : - a project manager so that you don't have to change the PHPDoc config each time you have a new project - a XSLT renderer cause I don't like template systems. - ability to add personnal tags because it's sometimes really useful. I had an intesting discussion with M@rms of the PHPedit project on this feature. - improve the XML output files beacause some are really bad looking (and so constantly improve the template system so that people can also use it if they donn't have the XSLT extension) That's also clear that the parser must be greatly improved. I'm not really experimented in developing parser or analyser so if you think you can help us on that it could be a great idea. I think we cannot follow all the javadoc specifications cause PHP is really different but that's sure that it could be great if we follow this specs most of the time. Currently the version I used is in French so I will translate this in English quickly so that you can see what I already implemented. G. > Since I tried to get answers to my questions as you are trying to do > (even mailing the the author - Ulf Wendel) a lot of times and no > response comes from anywhere we can take mantainership over it. > After that we start to develop it following the specifications of > JavaDoc: > > ---------- > http://java.sun.com/j2se/javadoc > ---------- > > Another option maybe consult other developers from PHP/PEAR to know > features most people want from it. > One thing you should know is that I can only spend my spare time on > that (about 4 hours a week - mostly on weekends), after college and > work. > And as I talked in earlier mails I'm still planning to develop my > conclusion tesis at college about PHPDoc. I just need at least one > person with some experience to help me on implementation (you), since > I'll use formal languages (as on compilers, with lexical and - maybe - > other analysis) to implement it. > If you want to help me on that I can start to talk to some professor > whom will guide me on the theory under that and than I can spent a lot > of hours/day and 2 semesters to release something *stable*. Accédez au courrier électronique de La Poste : www.laposte.net ; 3615 LAPOSTENET (0,13 €/mn) ; tél : 08 92 68 13 50 (0,34€/mn)"

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