On Fri, May 24, 2019 at 08:34:23PM +0200, Paolo Bonzini wrote: > On 23/05/19 14:20, John Snow wrote: > > OK, if that's where we're at! I just saw the RFC from Peter Maydell and > > assumed we were a little further along the decision making process, but > > maybe not. I'll stay tuned. > > For the decision making, yes; I think there's consensus to use > kerneldoc. For the "debugging and seeing if anything has changed in 2.5 > years", no. > > Testing the patch that Eduardo posted will help Gabriel, Eduardo and > everyone else decide whether to patch kerneldoc or rather change the API > doc comments style. (Personally I am in favor of patching; the > different coding conventions make using vanilla kerneldoc awkward, and > there are several thousands of lines of existing doc comments which > would require a transition.)
I'd prefer to fix our doc comments instead of patching kerneldoc, whenever possible. We don't even have a consistent doc comment style in QEMU. -- Eduardo
