On Thu, Apr 06, 2023 at 12:35:24PM +0200, Jiri Slaby wrote: > On 06. 04. 23, 12:12, Peter Zijlstra wrote: > > On Tue, Apr 04, 2023 at 07:03:45PM +0200, Paolo Bonzini wrote: > > > On 4/4/23 05:17, Lai Jiangshan wrote: > > > > The cover letter has 800+ lines of comments. About 100-300 lines > > > > of comments will be moved into the code which would make the diffstat > > > > not so appealing. > > > > > > Removing assembly from arch/x86/entry/ and adding English to Documentation/? > > > That's _even more_ appealing. :) > > > > I *much* prefer in-code comments to random gibberish that's instantly > > out of date squirreled away somewhere in an unreadable format in > > Documentation/ > > +1 as one can link comments in the code to Documentation easily nowadays. > They are sourced and end up in the generated Documentation [1] then. One > only needs to type the kernel-doc properly. Urgh, so that kernel doc stuff can defeat its purpose too. Some of that is so heavily formatted it is unreadable gibberish just like Documentation/ :/ I really detest that whole RST thing, and my solution is to explicitly not write kerneldoc, that way the doc generation stuff doesn't complain and I don't get random drive by patches wrecking the perfectly readable comment.
