Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933203AbcK1O3T (ORCPT ); Mon, 28 Nov 2016 09:29:19 -0500 Received: from ms.lwn.net ([45.79.88.28]:36046 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932876AbcK1O3K (ORCPT ); Mon, 28 Nov 2016 09:29:10 -0500 Date: Mon, 28 Nov 2016 07:29:08 -0700 From: Jonathan Corbet To: Daniel Vetter Cc: Peter Zijlstra , 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: <20161128072908.2472f347@lwn.net> In-Reply-To: <20161128141314.o6favw3o6eo3weww@phenom.ffwll.local> References: <20161125215814.GA3061@worktop.programming.kicks-ass.net> <20161127165914.5b84cc65@lwn.net> <20161128141314.o6favw3o6eo3weww@phenom.ffwll.local> Organization: LWN.net X-Mailer: Claws Mail 3.14.0 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 527 Lines: 13 On Mon, 28 Nov 2016 15:13:14 +0100 Daniel Vetter wrote: > Jon, should we document that we want a very light-handed approach to rst > markup in kernel docs? This has come up a few times now, and irrespective > of what exactly we're going to do with atomic_ops.txt I think it would > help with making txt->rst conversions palatable to the core kernel > community. And it's knida my own preference too ... I think that makes sense, yes. We just have to decide what a light-handed approach actually is... jon