[PHP-DOC] my work

[Mehdi Achour]

Hi ppl !

A little "compte-rendu" to let you know what I'm currently doing/need 
for livedocs.

1 - peardoc

As you know, I started testing peardoc on livedocs, you can see the 
result here : http://didou.keliglia.com/php/livedocs-pear/

There is a litle problem : some filenames uses underscores instead of 
hypens. I talked with peardoc guys, they are ok with a patch correcting 
this (work in progress)

I already prepared a patch for livedoc's build system, but I wanted to 
test smarty's doc too before commiting anything, and what a surprise..

2 - smarty docs

Just have a look : http://cvs.php.net/cvs.php/smarty/docs?login=2
the english files are in the root folder, the filenames uses .sgml 
instead of .xml, there's no ./configure && make stuff (they are using 
db2html ATM).
so I started another work : switching to a phpdoc like system for 
smarty's docs. In a first shot, I'm cleaning the english files (another 
work in progress)

I'll need some help to set up the build system there, anyone ?

3 - gtkdocs

Before having a look at smarty, I tried gtk-docs, but even a simple 
./configure didn't work (Steph is looking at this issue).
while talking with Step, she raised another problem that is slowing down 
gtk-docs : she's waiting for someone on phpdoc to decide on the approach 
that will be taken toward documenting OO classes there. Did we choose 
something ? Is Georg's way the good way ?

Answers are welcome :)

didou