Hi all

As a part of my Google Summer of Code work on Livedocs I decided to
upgrade our phpdoc to DocBook5.0RC4 as doing so after deploying
Livedocs would be really painful.

The patch is available at http://bjori.php.is/phpdoc/docbook5.upgrade.bz2
And phpweb_xsl build (thanks to Alex Songe for the build): http://lohan.php.is
This is a major change so I would appreciate if you could look through
the build.

99.5% of the changes are:
 - Replacing the id attribute with xml:id
 - Adding xmlns="http://docbook.org/ns/docbook"; to all root elements
 - Replace the <ulink /> elements with regular <link /> element using
the XLink:href attribute.

All three are rather simple to upgrade with a few line php/perl/shell script.

The 0.5% you'll pretty much have to grep for, but they include:
- "Randomly" added <para /> tags here and there in <entry />s
containing block elements
- Removing markup from <literal /> elements (or replace it with
something more meaningful).

I haven't dug through en/internals yet but will do soonish.

This patch will break _all_ (i.e. Japanese and French) translations
and they will need to upgrade too asap.

These changes should _not_ have any user _visible_ changes (there are
one or two or three markup changes) as it still uses the same
DocBook4-XSL, so if you find any differences please let me know.

Unless there are any scary looking objections I'll commit this.. say.. Monday?


Next on my GSoC schedule is to create a decent, readable and foxy
looking OO skeleton taking advantage of the kickass extendability of
DocBook5.
I was thinking I would use ext/reflection
(php.net/language.oop5.reflection) as a proof-of-concept example
extension for that work as it has to be moved anyway.


-Hannes

Reply via email to