Re: Which PHP 5.3 documentation generators have you found?

Re: Which PHP 5.3 documentation generators have you found?

am 30.09.2010 12:14:17 von Richard Quadling

On 29 September 2010 20:07, Adam Richardson wrote:
> On Wed, Sep 29, 2010 at 2:54 PM, ash@ashleysheridan.co.uk <
> ash@ashleysheridan.co.uk> wrote:
>
>> Does phpDocumenter not do the trick? I must admit, I've not tried anythi=
ng
>> specific to 5.3 (i can imagine the namespace thing would be a major part=
if
>> the documentation) but its served me well with other php5 code.
>>
>>
>>
> In the past I've been really pleased using phpDocumentor, however I'm afr=
aid
> the namespaces in 5.3 cause it to choke :(
>
> Adam
>
> --
> Nephtali:  PHP web framework that functions beautifully
> http://nephtaliproject.com
>

Gently side-stepping the namespace issue, I've used phpDocumentor with
the ExtJS extension to make really nice documentation
(http://zymengine.com/dev/news/30-phpdoc-extjs-converter-tem plate).

There are a few issues (http://code.google.com/p/zym/issues/list).
I've resolved some and supplied patches.

--=20
Richard Quadling
Twitter : EE : Zend
@RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Re: Re: Which PHP 5.3 documentation generators have you found?

am 30.09.2010 21:18:21 von Adam Richardson

--0015174beb1cf8b45f04917ef02e
Content-Type: text/plain; charset=ISO-8859-1

On Thu, Sep 30, 2010 at 2:30 PM, Erik L. Arneson wrote:

> On Wed, 29 Sep 2010, Adam Richardson wrote:
> > Hi all,
> >
> > Anybody know of a documentation generator which plays nicely with PHP
> > 5.3?
>
> I've always been a fan of phpDocumentor.
>
>
I agree, it's worked very well in the past. However, it looks like it's
been a while since a new release:
http://www.phpdoc.org/news.php?id=57

My code makes extensive use of namespaces and other new features found
within PHP 5.3, and these don't appear to be supported within phpDocumentor.

Any other options?

Adam

--
Nephtali: PHP web framework that functions beautifully
http://nephtaliproject.com

--0015174beb1cf8b45f04917ef02e--

Re: Re: Which PHP 5.3 documentation generators have you found?

am 30.09.2010 23:14:38 von David Harkness

--001485f6c80cd8a88104918090e6
Content-Type: text/plain; charset=ISO-8859-1

While we don't use any 5.3 specific features such as namespaces yet, we set
up our continuous integration system to use Doxygen. It runs significantly
faster than phpDocumentor, though we put zero effort into tuning either
system.

--001485f6c80cd8a88104918090e6--

Re: Re: Which PHP 5.3 documentation generators have you found?

am 01.10.2010 03:30:19 von Andrew Mason

On Fri, Oct 1, 2010 at 6:44 AM, David Harkness
wrote:
> While we don't use any 5.3 specific features such as namespaces yet, we set
> up our continuous integration system to use Doxygen. It runs significantly
> faster than phpDocumentor, though we put zero effort into tuning either
> system.
>

I started patching Doxygen a while ago but got sort of side tracked.
Out of PHPDocumentor and Doxygen, Doxygen seemed to be the closest as
it had namespace support already for other languages. only the tokens
needed changing. It uses Flex /Bison as the lexer and scanner so it's
pretty flexible. YMMV.

I have a bunch of FaiF code to release but i won't do so until i have
adequate documentation so I'll get around to adding support one of
these days.

--
PHP General Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php