On Tue, Apr 23, 2019 at 10:30:53AM -0600, Jonathan Corbet wrote:
On Tue, 23 Apr 2019 15:01:32 +0200 Peter Zijlstra peterz@infradead.org wrote:
But yes, I have 0 motivation to learn or abide by rst. It simply doesn't give me anything in return. There is no upside, only worse text files :/
So I believe it gives even you one thing in return: documentation that is more accessible for both readers and authors.
I know I'm an odd duck; but no. They're _less_ accessible for me, as both a reader and author. They look 'funny' when read as a text file (the only way it makes sense to read them; I spend 99% of my time on a computer looking at monospace text interfaces; mutt, vim and console, in that approximate order).
When writing, I now have to be bothered about this format crap over just trying to write a coherent document.
Look at crap like this:
"The memory allocations via :c:func:`kmalloc`, :c:func:`vmalloc`, :c:func:`kmem_cache_alloc` and"
That should've been written like:
"The memory allocations via kmalloc(), vmalloc(), kmem_cache_alloc() and"
Heck, that paragraph isn't even properly flowed.
Then there's the endless stuck ':' key, and the mysterious "''" because " isn't a character, oh wait.
Bah..