Thread (42 messages) 42 messages, 6 authors, 2020-07-21

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

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.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help