On 20/6/23 12:03, Richard Henderson wrote:
On 6/19/23 19:14, Alex Bennée wrote:
+We don't currently generate the API documentation for QDEV due to QEMU
+macros confusing the kerneldoc tool. For now see the headers in
+``include/hw/qdev-core.h``
+
+..
+ kernel-doc:: include/hw/qdev-core.h
I'm confused. Isn't that exactly what you're doing here?
IIUC the kernel-doc style comments from "hw/qdev-core.h"
are embedded as rST doc, see:
https://kernel.readthedocs.io/en/sphinx-samples/kernel-documentation.html#including-kernel-doc-comments
