> The extra documentation unfortunately just mechanically repeats what the > code does. Code comments should explain the reasoning behind the code, > instead.
Thanks for the helpful feedback - I appreciate you taking the time to review this. In v3 I'll: 1.Remove the parentheses from function names to match virtio conventions; 2.Simplify all descriptions to focus on purpose rather than repeating code mechanics; 3.Consolidate return value documentation to essential information only. The revised patch will maintain W=1 warning fixes while aligning with the kernel's documentation philosophy. I'll send the update shortly. Best regards, Peng Jiang