Auto-documenting existing code? (not just PhpDoc)

hi,

I would like to auto-doc some existing code, mostly so I can
understand it. I am slowly adding PhpDoc comments, but I miss some
tools which I have for C/c++.

For instance, the Code Visual to Flowchart - automatic code flow chart
generator at http://www.fatesoft.com/s2f/ looks great - but costs $180.
Does anyone know of anything which will anaylze PHP code and
auto-generate flowcharts ... for free? (a lot to ask, I know)

Or, more simply, what about a function call-tree generator? There are
any number of these as GPL for C - does anyone know of such a thing for
PHP?

Or even just something to show which files incldue which others, in a
large project?

Is anything else which might help, which have not mentioned? Preferably
freeware.

Thanks in advance.

re: Auto-documenting existing code? (not just PhpDoc)

Baron Samedi wrote:[color=blue]
> hi,
>
> I would like to auto-doc some existing code, mostly so I can
> understand it. I am slowly adding PhpDoc comments, but I miss some
> tools which I have for C/c++.
>
> For instance, the Code Visual to Flowchart - automatic code flow chart
> generator at http://www.fatesoft.com/s2f/ looks great - but costs $180.
> Does anyone know of anything which will anaylze PHP code and
> auto-generate flowcharts ... for free? (a lot to ask, I know)[/color]

Thanks for sharing the link. FAIK, in PHP there is no tools like
CodeSMART for VB.
[color=blue]
> Or, more simply, what about a function call-tree generator? There are
> any number of these as GPL for C - does anyone know of such a thing for
> PHP?
>
> Or even just something to show which files incldue which others, in a
> large project?[/color]

You may still use phpdoc without the doc tags and check the
generated document. It will have the included files info and etc.
Doxygen can also be used in this case. FWIW, in PHPEdit
<http://www.waterproof.fr/> you may easily add (not that easy as
CodeSMART) the doc comments.

--
<?php echo 'Just another PHP saint'; ?>
Email: rrjanbiah-at-Y!com Blog: http://rajeshanbiah.blogspot.com/

re: Auto-documenting existing code? (not just PhpDoc)

R. Rajesh Jeba Anbiah wrote:[color=blue][color=green]
> > For instance, the Code Visual to Flowchart - automatic code flow chart
> > generator at http://www.fatesoft.com/s2f/ looks great - but costs $180.
> > Does anyone know of anything which will anaylze PHP code and
> > auto-generate flowcharts ... for free? (a lot to ask, I know)[/color]
>
> Thanks for sharing the link. FAIK, in PHP there is no tools like
> CodeSMART for VB.[/color]

Raj, I also want to look at http://sourceforge.net/projects/algoview
for C.

I wonder, can it be easilly converted to PHP ? After all the keyword
which control flow are the question (if/else/switch/case/for/while)

re: Auto-documenting existing code? (not just PhpDoc)

Baron Samedi wrote:[color=blue]
> R. Rajesh Jeba Anbiah wrote:[color=green][color=darkred]
> > > For instance, the Code Visual to Flowchart - automatic code flow chart
> > > generator at http://www.fatesoft.com/s2f/ looks great - but costs $180.
> > > Does anyone know of anything which will anaylze PHP code and
> > > auto-generate flowcharts ... for free? (a lot to ask, I know)[/color]
> >
> > Thanks for sharing the link. FAIK, in PHP there is no tools like
> > CodeSMART for VB.[/color]
>
> Raj, I also want to look at http://sourceforge.net/projects/algoview
> for C.
>
> I wonder, can it be easilly converted to PHP ? After all the keyword
> which control flow are the question (if/else/switch/case/for/while)[/color]

Yes, I hope so. But, I must confess that I didn't look at the
source as I won't be having time to play with it. And the software
looks awesome.

--
<?php echo 'Just another PHP saint'; ?>
Email: rrjanbiah-at-Y!com Blog: http://rajeshanbiah.blogspot.com/

re: Auto-documenting existing code? (not just PhpDoc)

R. Rajesh Jeba Anbiah wrote:[color=blue][color=green]
> > Raj, I also want to look at http://sourceforge.net/projects/algoview
> > for C.
> >
> > I wonder, can it be easilly converted to PHP ? After all the keyword
> > which control flow are the question (if/else/switch/case/for/while)[/color]
>
> Yes, I hope so. But, I must confess that I didn't look at the
> source as I won't be having time to play with it. And the software
> looks awesome.[/color]

I am busy (extremely overloaded) myself, at the moment, but if I ever
do port this, I will post here.