all translations in current CVS should now be prepared for the conversion to DocBook 4, i've done final tests and fixes yesterday
i'd like to perform and commit the actual conversion on late friday (european time), so if you have pending contributions, especialy for the reference part, you should either have them commited on friday or make sure you can run the conversion script yourself (you can still commit documents using old-style function prototypes, but you'll break the builds until someone else converts these for you) the conversion script rewrites <funcsynopsis> blocks to the new <methodsynopsis>. the way we marked optional parameters is not compatible with DocBook4, so we have to apply changes anyway. by using <methodsynopsis> instead of <funcsynopsis> we should gain some additional advantages like easier markup and processing of optional arguments. the incompatibility issues between docbook 3 and 4 i've stumbled across were: - <option> and <optional> are no longer usable without <replaceable> this affects the way we wrote command line options, esp. to configure, in some places and optional arguments in function prototypes i've deleted the tags from command line arguments, we should have a look at <commandsynopsis> and friends to see how this is done right as sone as conversion is done for the function prototypes we get rid of <optional> by switching to <methodsynopsis> - <comment> no longer exists used only in one place, replaced by a simple <!-- --> new features we can make use of: - <ooclass>, <classsynopsis> and friends for OO-documentation - EBNF extension, so we can have a formal php syntax description ;) ... -- Hartmut Holzgraefe [EMAIL PROTECTED] http://www.six.de +49-711-99091-77
