Messages in this thread | | | From | Thomas Gleixner <> | Subject | Re: [PATCH v1 10/25] seqlock: Add RST directives to kernel-doc code samples and notes | Date | Fri, 22 May 2020 20:26:44 +0200 |
| |
Peter Zijlstra <peterz@infradead.org> 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.
| |