Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753061AbdFQPDL (ORCPT ); Sat, 17 Jun 2017 11:03:11 -0400 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:38375 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752066AbdFQPDK (ORCPT ); Sat, 17 Jun 2017 11:03:10 -0400 Date: Sat, 17 Jun 2017 12:03:01 -0300 From: Mauro Carvalho Chehab To: Linus Walleij Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , "linux-kernel@vger.kernel.org" , Jonathan Corbet , David Woodhouse , Brian Norris , Boris Brezillon , Marek Vasut , Richard Weinberger , Cyrille Pitchen , "linux-mtd@lists.infradead.org" , "linux-gpio@vger.kernel.org" Subject: Re: [PATCH 01/29] pinctrl.txt: standardize document format Message-ID: <20170617120301.057229bc@vento.lan> In-Reply-To: References: Organization: Samsung X-Mailer: Claws Mail 3.14.1 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1916 Lines: 64 Em Tue, 23 May 2017 11:12:43 +0200 Linus Walleij escreveu: > On Fri, May 19, 2017 at 3:25 AM, Mauro Carvalho Chehab > wrote: > > > Each text file under Documentation follows a different > > format. Some doesn't even have titles! > > > > Change its representation to follow the adopted standard, > > using ReST markups for it to be parseable by Sphinx. > > > > This document is almost following the standard stile. > > > > There are only two things to adjust on it: > > > > - promote the level of the document title; > > - mark literal blocks as such. > > > > Signed-off-by: Mauro Carvalho Chehab > > I applied the patch fixing some of the indentation mistakes pointed > out by Geert. Thanks! (sorry for not answering earlier... got sidetracked by two trips) > Should the file be renamed pinctrl.rst now? If you just rename it, Sphinx will complain because it doesn't belong to any index.rst file. As this is part of drivers/, I guess the right thing is to add it to driver-api book. The enclosed patch should be doing it (it is based on linux-next). Thanks, Mauro [PATCH] pinctrl.txt: move it to the driver-api book As pinctrl describes a feature from drivers/base, place it at the right book. Signed-off-by: Mauro Carvalho Chehab diff --git a/Documentation/driver-api/index.rst b/Documentation/driver-api/index.rst index 3cf1acebc4ee..7c94ab50afed 100644 --- a/Documentation/driver-api/index.rst +++ b/Documentation/driver-api/index.rst @@ -43,6 +43,7 @@ available subsections can be seen below. 80211/index uio-howto firmware/index + pinctl misc_devices .. only:: subproject and html diff --git a/Documentation/pinctrl.txt b/Documentation/driver-api/pinctl.rst similarity index 100% rename from Documentation/pinctrl.txt rename to Documentation/driver-api/pinctl.rst