My first idea was to create an <article> for each class, with a first section Detailed Description, then another one Member Function Documentation (mapping the structure of the original documentation); avoiding those sections would even be better, as they add no semantics to the document. This second section would have contained a <classsynopsis> with all the methods in <methodsynopsis> and their documentation (i.e. a set of paragraphs for each method). However, a <methodsynopsis> does not allow textual content as <para>.
<?xml version="1.0" encoding="UTF-8"?>
<db:article xmlns:db="
http://docbook.org/ns/docbook" xmlns:xlink="
http://www.w3.org/1999/xlink"
version="5.0">
<db:info>
<db:title>QLowEnergyCharacteristic</db:title>
</db:info>
<db:section>
<db:title>Detailed Description</db:title>
<db:para>The <db:link xlink:href=""> >QLowEnergyCharacteristic</db:link> class stores information about a Bluetooth Low
Energy service characteristic.</db:para>
<!-- ... -->
</db:section>
<db:section>
<db:title>Member Function Documentation</db:title>
<db:classsynopsis>
<db:ooclass>
<db:classname>QLowEnergyCharacteristic</db:classname>
</db:ooclass>
<db:constructorsynopsis xml:id="QLowEnergyCharacteristic">
<db:para>Construct a new QLowEnergyCharacteristic. A default-constructed instance of this class is always invalid.</db:para>
</db:constructorsynopsis>
<db:constructorsynopsis xml:id="QLowEnergyCharacteristic-2">
<db:methodparam>
<db:modifier>const</db:modifier>
<db:type>QLowEnergyCharacteristic &</db:type>
<db:parameter>other</db:parameter>
</db:methodparam>
<db:para>Construct a new QLowEnergyCharacteristic that is a copy of other.</db:para>
</db:constructorsynopsis>
<!-- ... -->
</db:classsynopsis>
</db:section>
</db:article>
. It uses one section per class, starting with a <classsynopsis>, then nested sections afterwards for the methods if there is anything to say about them.
This way of doing things makes me feel dubious, as there is no direct link between the class and its method: each method basically copies a part of the class definition. In my case, as all methods have a few words about them, there is a high risk of someone changing (inadvertently) a letter or anything (<classsynopsis> could even be avoided); and at the semantic level, the notion of class or method documentation would be completely lost (as the real documentation would just be a set of sections).