Re: [PATCH v1 10/25] seqlock: Add RST directives to kernel-doc code samples and notes

From: Peter Zijlstra
Date: Fri May 22 2020 - 14:03:11 EST


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 :-(