Re: Minor RST rant

From: peterz
Date: Wed Jul 29 2020 - 08:45:00 EST


On Sat, Jul 25, 2020 at 09:46:55AM +1000, NeilBrown wrote:

> Constant names stand out least effectively by themselves. In
> kernel-doc comments they are preceded by a '%'. Would that make the
> text more readable for you? Does our doc infrastructure honour that in
> .rst documents?

It does not. It also still reads really weird.

And for some reason firefox chokes on the HTML file I tried it with, and
make htmldocs takes for bloody ever.

Give me a plain text file, please. All this modern crap just doesn't
work.