Re: [GSOC] I want to participate in gsoc 2009

On Tue, Mar 3, 2009 at 20:02, Moacir de Oliveira
<[email protected]> wrote:
> OK Igor, thanks for your help.
>
> Now I'm looking for more information about PhD Project.
>
> I have some questions for the PhD's mentor, Hannes Magnusson:
>
> 1) what was implemented in the PhD last year?

Last year focus was on adding support for more output formats, such as
PDF, Unix manual pages and CHM files. KDevelop support was also added,
and the initial PEAR themes got in too.

> 2) What are the improvements in the PhD Project for this gsoc?

This year we were hoping to get PhD into more generic shape.
As of today PhD does a great job for php.net, but for other projects
some workarounds are required, and annoying issues have to be dealt
with.
For example, the PhD manual itself has the title "PEAR Manual"
(http://doc.php.net/phd/docs/)..

Furthermore we want to split up the various formats into "standalone
components", and the same for themes.
That would make it possible to only install the things you need and want.
To install the xhtml formats, for example, you would do:
pear install doc.php.net/phd-xhtml

And then for the phpdoc "built-in theme" you'd type:
pear install doc.php.net/phd-xhtml-phpdoc

And to install all formats and themes:
pear install doc.php.net/phd-all

This would make it easier for "external" guys to write there own
customization layers.

We have also been playing around with the idea of killing themes, just
making them real output formats, but thats not as easy as it sound..

Another part we would like to get done is the "setup" issues
(PhD-Setup). PhD has a lot of configuration settings, but its really
annoying needing to pass them all on the command line - in fact, you
can't even configure all options from the command line, so some sort
of a config.nice and a better "configure" process is required.
Another part of it would to replace the various configure.php scripts
we (phpdoc and peardoc) have.

And at last, PHP-Gtk will hopefully be upgrading to DocBook5 soon, and
will be using PhD to render their docs too.
They will probably need their own theme, so helping them out would be great.


-Hannes