From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail.linuxfoundation.org ([140.211.169.12]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dBaa5-0008NL-6k for linux-mtd@lists.infradead.org; Fri, 19 May 2017 05:36:06 +0000 Date: Fri, 19 May 2017 07:35:31 +0200 From: Greg Kroah-Hartman To: Mauro Carvalho Chehab 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 Subject: Re: [PATCH 10/30] kobject.txt: standardize document format Message-ID: <20170519053531.GB5408@kroah.com> References: <8d58526134d4616ad7a93a58059b5473a65231b2.1495156975.git.mchehab@s-opensource.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <8d58526134d4616ad7a93a58059b5473a65231b2.1495156975.git.mchehab@s-opensource.com> List-Id: Linux MTD discussion mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , On Thu, May 18, 2017 at 10:24:02PM -0300, 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: > > - Add markups for titles; > - mark literal blocks as such; > - add needed whitespace/blank lines; > - use :Author: and :Last updated: for authorship. > > Signed-off-by: Mauro Carvalho Chehab Acked-by: Greg Kroah-Hartman