[DocBook] Proposal: allow optional <type> element in <enumsynopsis> element

Gina P. Banyard internals at gpb.moe
Sat Mar 7 06:47:05 PST 2026


Hello everyone,

I'd like to propose a small amendment to the <enumsynopsis> tag for the next version of DocBook. (which I guess will be 5.3?)
The proposal is to allow an optional <type> element after the optional <enumname> tag.

The motivation is that C (since C23), C++, and PHP (which is my main motivation for the proposal) allow specifying the backing type of individual enum cases.
I initially thought of using the <modifier> tag that is allowed after the <enumname> tag, however it doesn't accept an inline <type> tag.

Would love to hear other opinions!

Best regards,

Gina P. Banyard


More information about the DocBook mailing list