so

DocBook 5.2.1

Volume 10, Issue 15; 23 Mar 2026

I’ve updated the website, the content distribution site, the Maven packages, the documentation, and published the releases.

I’m still on holiday so this is a bit of a low-effort #MarkupMonday post. A few days ago, I finished testing the small update that removes a backwards incompatibility accidentally introduced in DocBook 5.2.

Shout out to the folks who tried out ꞵ1 and reported what they found. I made a few small changes, but mostly avoided the temptation to do more than fix the bug:

  • Fixed the backwards incompatibility that only a single ooclass, ooexception, or oointerface was allowed in classsynopsis where previously any number were allowed.
  • Fixed the “standard” URIs for DocBook Publishers. The 5.2 locations still work for 5.2, but for 5.2.1, there’s a leading /xml/ on the URI for better parity with the standard DocBook release. (As far as I can tell from the documentation, that was always the intent.)
  • Fixed the typo in the description of the condition attribute. (The description sentence began with a lower-case letter.)
  • Corrected several Schematron rules related to callout cross references. As written the rules were failing to catch some error cases.

The DocBook website has been updated, and so have the files on the CDN. New DocBook and DocBook Publishers Maven packages have been published. The documentation has been updated. A new release is available.

Remember to sign up for the new, public mailing lists if you want to discuss what should go in 5.3 or 6.0.

#DocBook #MarkupMonday #XML

Please provide your name and email address. Your email address will not be displayed and I won’t spam you, I promise. Your name and a link to your web address, if you provide one, will be displayed.

Your name:

Your email:

Homepage:

Do you comprehend the words on this page? (Please demonstrate that you aren't a mindless, screen-scraping robot.)

What is four plus three?   (e.g. six plus two is 8)

Enter your comment in the box below. You may style your comment with the CommonMark flavor of Markdown.

All comments are moderated. I don’t promise to preserve all of your formatting and I reserve the right to remove comments for any reason.