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.