Re: PHPDoc again
| From: | Antônio Carlos Venâncio Júnior | Date: | Thu, 20 Jun 2002 00:45:24 +0000 |
| Subject: | Re: PHPDoc again | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-7215@lists.php.net to get a copy of this message | ||
Guillaume,
On Mon, 2002-06-17 at 12:10, Guillaume SMET wrote:
> ok
> I'll mail you soon. I have to put some order in my sourcecode
> before :) and translate some french words in the generated doc.
>
> Is there any document which describes precisely what PHPDoc
> must do ? For example, I don't like template systems but I'm
> not sure using the XSLT extension is a good solution because
> it's not a common extension (really few people install it).
> It's the same problem with the DOMXML extension. Can we use
> PHP4 only code or have we to be PHP3 compliant ?
> Do we have to maintain the template solution up to date or can
> we forget it ?
> I don't have any answer to my questions so it's pretty
> difficult to take a decision :/
>
> I think that people using PHPDoc (and I think PEAR use it) may
> feel concerned by improving this tool. There are really good
> ideas in the current version but there are also many annoying
> bug. Perhaps it's not really the point currently with everyone
> looking on the installation procedure...
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*.
--
Ate´
Antonio
"Can't buy what I want because its FREE!" - Pearl Jam
floripa@PHP.net | PHP & FreeBSD & MySQL | PGP Key ID 0x5BBEB073
Attachment: [application/pgp-signature] This is a digitally signed message part signature.asc
Attachment: [application/pgp-signature] This is a digitally signed message part signature.asc