On Fri, May 22, 2020 at 08:26:44PM +0200, Thomas Gleixner wrote: > Peter Zijlstra <peterz@xxxxxxxxxxxxx> writes: > > On Fri, May 22, 2020 at 08:02:54PM +0200, Peter Zijlstra wrote: > >> On Tue, May 19, 2020 at 11:45:32PM +0200, Ahmed S. Darwish wrote: > >> > Mark all C code samples inside seqlock.h kernel-doc text with the RST > >> > 'code-block: c' directive. Sphinx won't properly format the example code > >> > and will produce noisy text indentation warnings otherwise. > >> > >> I so bloody hate RST.. and now it's infecting perfectly sane comments > >> and turning them into unreadable junk :-( > > > > The correct fix is, as always, to remove the kernel-doc marker. > > Get over it already. I will not let sensible code comments deteriorate to the benefit of some external piece of crap. As a programmer the primary interface to all this is a text editor, not a web broswer or a pdf file or whatever other bullshit. If comments are unreadable in your text editor, they're useless.
