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.) Paolo