Support for PHP namespaces

[Karsten Dambekalns-3]

Hi.

We are currently looking into using Doxygen for FLOW3/TYPO3v5 after  
having switched to using PHP namespaces. Currently we use  
phpDocumentor, but it seems to be inactive so support for namespaces  
might never come...

A first try with Doxygen looks promising, but one thing that is a  
showstopper is missing support for PHP namespaces. Admittedly it is  
not yet fully clear whether PHP will use
  namespace X::Y::Z;
or rather
  namespace X::Y::Z { ..: }
but this is about everything that remains to be seen.

I ran Doxygen in our codebase, and it detects "some" namespace, but  
e.g. the class hierarchy is completely flat.

What would be the best way of getting Doxygen nearer to what we need  
given that I have never coded C? Who is maintaining the PHP support of  
Doxygen?

Regards,
Karsten
--
Karsten Dambekalns
Gimme Five!
http://typo3.org/gimmefive




-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop@...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

[Dimitri van Heesch-2]

On 16 sep 2008, at 11:28, Karsten Dambekalns wrote:

> Hi.
>
> We are currently looking into using Doxygen for FLOW3/TYPO3v5 after  
> having switched to using PHP namespaces. Currently we use  
> phpDocumentor, but it seems to be inactive so support for namespaces  
> might never come...
>
> A first try with Doxygen looks promising, but one thing that is a  
> showstopper is missing support for PHP namespaces. Admittedly it is  
> not yet fully clear whether PHP will use
> namespace X::Y::Z;
> or rather
> namespace X::Y::Z { ..: }
> but this is about everything that remains to be seen.
>
> I ran Doxygen in our codebase, and it detects "some" namespace, but  
> e.g. the class hierarchy is completely flat.
>
> What would be the best way of getting Doxygen nearer to what we need  
> given that I have never coded C? Who is maintaining the PHP support  
> of Doxygen?

I'm maintaining everything related to Doxygen, so also PHP support ;-)

I suggest to file a bug report with severity set to enhancement about  
this feature request and
include some (references to) examples of typically usages (and/or a  
link to a formal grammar).

 From what I seen so far, it should basically be enough if doxygen  
treats
"namespace X::Y::Z;", as if "namespace X { namespace Y { namespace Z  
{" had been written in C#/C++ (where the
closing }'s are all at the end of the file. Is this correct?

Regards,
   Dimitri


-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop@...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

[Karsten Dambekalns-3]

Hi Dimitri,

thanks for the quick response!

On 16.09.2008, at 20:36, Dimitri Van Heesch wrote:
> I suggest to file a bug report with severity set to enhancement  
> about this feature request and
> include some (references to) examples of typically usages (and/or a  
> link to a formal grammar).

I'll do so.

> From what I seen so far, it should basically be enough if doxygen  
> treats
> "namespace X::Y::Z;", as if "namespace X { namespace Y { namespace Z  
> {" had been written in C#/C++ (where the
> closing }'s are all at the end of the file. Is this correct?


That should be ok, yes. It might be that the PHP core developers  
change namespace handling slightly to make it block-level, so that we  
could have "namespace X::Y::Z { ... }" and a possible nesting. That  
would be a "mixture of both worlds" so to speak.

Regards,
Karsten
--
Karsten Dambekalns
Gimme Five!
http://typo3.org/gimmefive




-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop@...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop