RE: [PEAR] PHPdoc CVS repository
| From: | Florian Clever | Date: | Wed, 28 Nov 2001 22:24:47 +0000 |
| Subject: | RE: [PEAR] PHPdoc CVS repository | ||
| References: | 1 | Groups: | php.pear.general |
| Request: | Send a blank email to pear-general+get-557@lists.php.net to get a copy of this message | ||
Thanks Joshua,
I downloaded your snapshot. It looks better (for example it does not through
this array_map error anymore), however there seems to be an issue in regards
to filenames.
I am running on Windows 2000. All non-class files (thus all the procedural
files) get the name "_". So basically it writes all data into a file called
"_" over and over again, everytime essentially wiping out the previous file.
This did not happen with the 0.2.5 release.
It might be just a windows issue, because if you enter paths with "\" it
outputs them as "\\".
I did not have time yet too look at the source code, but maybe you already
know what I am talking about.
Florian
> -----Original Message-----
> From: Joshua Eichorn [mailto:jeichorn@JoshuaEichorn.com]
> Sent: Wednesday, November 28, 2001 12:52 PM
> To: Florian Clever
> Cc: pear-general@lists.php.net
> Subject: Re: [PEAR] PHPdoc CVS repository
>
>
> Florian,
> Glad i could help you out. Hopefully this christmas i'll write a
> new version using the new php extension for doing the parsing.
> You should be able to simple put a docblock at the top of a page, and as
> long as the next documentable element is also documented
> then is will use the first one as a page summary. For example:
>
> <?php
> /**
> * A page containing all of my constants
> */
>
> /**
> * A constant
> */
> define("test","test");
> ?>
>
> However there seems to be a bug in the code and this isn't working. It
> seems I didn't have that section in the template.
> I've fixed the bug and put a new snapshot up at
http://developer.phpdoc.org
-joshua eichorn
Florian Clever wrote:
>Joshua,
>
>thanks for the link. It works pretty well.
>Is it possible to get it to output somekind of general file summary at the
>top for procedural files?
>Just below Page:/root/filename.
>Similar to the brief description displayed for classes just below the
>classname.
>I guess you could also call it a file @abstract.
>
>Florian
>
>>-----Original Message-----
>>From: Joshua Eichorn [mailto:jeichorn@joshuaeichorn.com]
>>Sent: Tuesday, November 27, 2001 6:10 PM
>>To: Florian Clever
>>Cc: pear-general@lists.php.net
>>Subject: Re: [PEAR] PHPdoc CVS repository
>>
>>
>>If you want to work on phpdoc check the new php2xml phpdoc ext that
>>produces xml of your php code using the zend engine.
>>also if you just need some documentation now and dont want to work on
>>lots of code, you might want to look at some of the other
>>phpdoc implementations out there. For example i got a version at
>>http://phpdoc.org
>>
>>-joshua eichorn
>>
>>Florian Clever wrote:
>>
>>>I am currently using the PHPdoc 1.0beta and running into a few problems
>>>which I am looking into fixing.
>>>I would like to check against the current PHPdoc CVS version to
>>>
>>see if some
>>
>>>of that is already fixed.
>>>However I am unable to find the CVS repository for PHPdoc.
>>>www.phpdoc.de states it should be at cvs.php.net/php4/pear/phpdoc.
>>>However that directory seems to be empty.
>>>
>>>Anybody who could shine some light on this.
>>>thanks a lot,
>>>Flori
>>>
>>>
>>
>