[DocBook] DocBook 5.2 incompatibility from DocBook 5.1

Gina P. Banyard internals at gpb.moe
Wed Feb 25 09:22:55 PST 2026


Hello DocBook Mailing List,

I opened an issue a while on the GitHub repo about this topic. [1]

But the quick recap is that in DocBook 5.1 the <classsynopsis> allows the usage of "one or more" Object-oriented programming inlines (i.e one of the <ooclass>, <ooexception>, <oointerface> tags).
However, in DocBook 5.2 this got changed to "One of".

This is a small issue for the PHP documentation, and as such I have patched the RelaxNG schema to use "one or more".
I don't know if DocBook is able to relax a "bug fix" release of the schema? If yes that would be ideal. :)

Best regards,

Gina P. Banyard

[1] https://github.com/docbook/docbook/issues/262


More information about the DocBook mailing list