Re: [PATCH v1 10/25] seqlock: Add RST directives to kernel-doc code samples and notes
From: Thomas Gleixner <hidden>
Date: 2020-05-22 18:27:02
Also in:
lkml
From: Thomas Gleixner <hidden>
Date: 2020-05-22 18:27:02
Also in:
lkml
Peter Zijlstra [off-list ref] writes:
On Fri, May 22, 2020 at 08:02:54PM +0200, Peter Zijlstra wrote:quoted
On Tue, May 19, 2020 at 11:45:32PM +0200, Ahmed S. Darwish wrote:quoted
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.