Re: [PATCH v3 2/4] Documentation/atomic_ops.txt: convert to ReST markup

From: Peter Zijlstra
Date: Mon Nov 28 2016 - 02:26:43 EST


On Sun, Nov 27, 2016 at 04:59:14PM -0700, Jonathan Corbet wrote:
> On Fri, 25 Nov 2016 22:58:14 +0100
> Peter Zijlstra <peterz@xxxxxxxxxxxxx> wrote:
>
> > Not a fan of this. The atomic_ops.txt file needs a lot of love, and I
> > wouldn't want to edit a .rst file.
> >
> > Then again, I probably won't actually get around to fixing this document
> > any time soon either.
> >
> > But if and when I would get around to it, I'll have to change it back to
> > a regular .txt file.
>
> Peter, could you please describe what the trouble with RST is?

Mostly that its not txt. I don't know what RST is, and I frankly don't
care. For me changing this is 'make work', and I really don't need that.

Changing this away from txt will simply make want to write documentation
less, because it means having to figure out wtf RST is first, which
means I'll simply won't do it.

> Most of
> the files in Documentation/ are already almost in RST format; should we
> change them to something else? :)

Why change them? What was wrong with txt to begin with?