Home
last modified time | relevance | path

Searched hist:"4 cf41794411f91453e19da88ecb7e806a831abf8" (Results 1 – 1 of 1) sorted by relevance

/openbmc/qemu/scripts/
H A Dkernel-doc4cf41794411f91453e19da88ecb7e806a831abf8 Tue Oct 29 11:22:44 CDT 2019 Paolo Bonzini <pbonzini@redhat.com> docs: tweak kernel-doc for QEMU coding standards

Surprisingly, QEMU does have a pretty consistent doc comment style and
it is not very different from the Linux kernel's. Of the documentation
"sigils", only "#" separates the QEMU doc comment style from Linux's,
and it has 200+ instances vs. 6 for the kernel's '&struct foo' (all in
accel/tcg/translate-all.c), so it's clear that the two standards are
different in this respect. In addition, our structs are typedefed and
recognized by CamelCase names.

Adjust kernel-doc's parser for these two aspects of the QEMU coding
standards. The patch has been valid, with hardly any change, for over
two years, so it should not be an issue to keep kernel-doc in sync with
the Linux copy.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>