Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754508AbcK1H0l (ORCPT ); Mon, 28 Nov 2016 02:26:41 -0500 Received: from bombadil.infradead.org ([198.137.202.9]:38574 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754289AbcK1H0d (ORCPT ); Mon, 28 Nov 2016 02:26:33 -0500 Date: Mon, 28 Nov 2016 08:26:26 +0100 From: Peter Zijlstra To: Jonathan Corbet Cc: Silvio Fricke , linux-doc@vger.kernel.org, Ming Lei , "Luis R . Rodriguez" , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jani Nikula Subject: Re: [PATCH v3 2/4] Documentation/atomic_ops.txt: convert to ReST markup Message-ID: <20161128072626.GT3092@twins.programming.kicks-ass.net> References: <20161125215814.GA3061@worktop.programming.kicks-ass.net> <20161127165914.5b84cc65@lwn.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20161127165914.5b84cc65@lwn.net> User-Agent: Mutt/1.5.23.1 (2014-03-12) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1045 Lines: 27 On Sun, Nov 27, 2016 at 04:59:14PM -0700, Jonathan Corbet wrote: > On Fri, 25 Nov 2016 22:58:14 +0100 > Peter Zijlstra 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?