Matthew Wilcox wrote: > On Fri, Mar 22, 2024 at 12:10:38PM -0700, Dan Williams wrote: > > Peter Zijlstra wrote: > > > So I despise all that RST stuff. It makes what should be trivially > > > readable text into a trainwreck. We're coders, we use text editors to > > > read comments. > > > > Ok, I will rip out the RST stuff and just make this a standalone comment. > > I would rather you ignored Peter's persistent whining about RST and > kept the formatting. Hmm, how about split the difference and teach scripts/kernel-doc to treat Peter's preferred markup for a C code example as a synonym, i.e. effectively a search and replace of a line with only: Ex. ...with: .. code-block:: c ...within a kernel-doc DOC: section? Might be easier said the done as I stare down a pile of perl. Maybe a perl wrangler will come along and take pity on this patch.
