Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751342AbeACXsm (ORCPT + 1 other); Wed, 3 Jan 2018 18:48:42 -0500 Received: from merlin.infradead.org ([205.233.59.134]:37960 "EHLO merlin.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750945AbeACXsl (ORCPT ); Wed, 3 Jan 2018 18:48:41 -0500 Date: Thu, 4 Jan 2018 00:48:28 +0100 From: Peter Zijlstra To: afzal mohammed Cc: linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, "Paul E. McKenney" , Will Deacon , Ingo Molnar , Stan Drozd , Palmer Dabbelt , Mauro Carvalho Chehab , Jonathan Corbet Subject: Re: [PATCH] doc: memory-barriers: reStructure Text Message-ID: <20180103234828.GB32035@hirez.programming.kicks-ass.net> References: <20180103093436.16704-1-afzal.mohd.ma@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20180103093436.16704-1-afzal.mohd.ma@gmail.com> User-Agent: Mutt/1.9.2 (2017-12-15) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Return-Path: On Wed, Jan 03, 2018 at 03:04:36PM +0530, afzal mohammed wrote: > Let PDF & HTML's be created out of memory-barriers Text by > reStructuring. > > reStructuring done were, > 1. Section headers modification, lower header case except start > 2. Removal of manual index(contents section), since it now gets created > automatically for html/pdf > 3. Internal cross reference for easy navigation > 4. Alignment adjustments > 5. Strong emphasis made wherever there was emphasis earlier (through > other ways), strong was chosen as normal emphasis showed in italics, > which was felt to be not enough & strong showed it in bold > 6. ASCII text & code snippets in literal blocks > 7. Backquotes for inline instances in the paragraph's where they are > expressed not in English, but in C, pseudo-code, file path etc. > 8. Notes section created out of the earlier notes > 9. Manual numbering replaced by auto-numbering > 10.Bibliography (References section) made such that it can be > cross-linked > > Signed-off-by: afzal mohammed So I hate this rst crap with a passion, so NAK from me.