Re: [PATCH] docs/completion.txt: Fix a couple of punctuation nits

From: Peter Zijlstra
Date: Fri Oct 12 2018 - 05:32:51 EST


On Thu, Oct 11, 2018 at 09:46:56PM +0300, Jani Nikula wrote:
> On Thu, 11 Oct 2018, Peter Zijlstra <peterz@xxxxxxxxxxxxx> wrote:
> > On Thu, Oct 11, 2018 at 08:29:10AM -0700, Matthew Wilcox wrote:
> >> On Wed, Oct 10, 2018 at 10:56:32PM +0800, John Garry wrote:
> >> > This patch fixes a couple of punctuation nits which can make the document
> >> > more correct and readable.
> >> >
> >> > Also missing "()" are added to some function references for consistency.
> >>
> >> While there's nothing wrong here, any chance you want to try converting
> >> it to .rst and adding it to the overall index? It looks a lot like
> >> rst already.
> >
> > I, on principle, will not touch rst files. They are inferior to txt files.
>
> $ git shortlog --author=Zijlstra -- Documentation/scheduler/
>
> It does not look like you touch txt files either.

True; I prefer comments in the code. I did however write some text on
atomics the other day, see Documentation/atomic_{t,bitops}.txt.