Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752549AbcLFM6u (ORCPT ); Tue, 6 Dec 2016 07:58:50 -0500 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:50185 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751166AbcLFM6q (ORCPT ); Tue, 6 Dec 2016 07:58:46 -0500 Date: Tue, 6 Dec 2016 10:51:51 -0200 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , LKML , Brian Norris , Mauro Carvalho Chehab Subject: Re: [PATCH 0/5] Update Documentation/00-INDEX Message-ID: <20161206105151.2bde0881@vento.lan> In-Reply-To: <20161205142301.58f5a129@lwn.net> References: <20161205142301.58f5a129@lwn.net> 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: 2697 Lines: 78 Em Mon, 5 Dec 2016 14:23:01 -0700 Jonathan Corbet escreveu: > On Mon, 5 Dec 2016 09:41:40 -0200 > Mauro Carvalho Chehab wrote: > > > So, in order to check it, I wrote a small script that compares the files > > and directories at Documentation/ with the ones at 00-INDEX. > > > > Then, I synchronized the entries, making the script happy. > > > > We might think on integrating the script with checkpatch.pl, but, as > > we should get rid of 00-INDEX, it probably not worth the efforts. > > I would agree with that; I don't see the point of keeping those files > around in the longer term. > > I've applied the set. I do have a few quibbles with the final patch that > I'll send separately, but they're not something to hold this set up for. Jon, Did a patch fixing the quibbles. As it seems you didn't push yet the changeset upstream, feel free to just fold it with patch 5/5 if you prefer so, or to add as a separate patch at the end of the series. Patch enclosed. Thanks, Mauro [PATCH] docs: 00-INDEX: change text related to the building system Let be clearer on those files related to the build system. Signed-off-by: Mauro Carvalho Chehab diff --git a/Documentation/00-INDEX b/Documentation/00-INDEX index 6d488509285d..5bd4b07c2f90 100644 --- a/Documentation/00-INDEX +++ b/Documentation/00-INDEX @@ -39,11 +39,9 @@ IRQ.txt Intel-IOMMU.txt - basic info on the Intel IOMMU virtualization support. Makefile - - This file does nothing. Removing it breaks make htmldocs and - make distclean. + - It's not of interest for those who aren't touching the build system. Makefile.sphinx - - This file does nothing. Removing it breaks make htmldocs and - make distclean. + - It's not of interest for those who aren't touching the build system. PCI/ - info related to PCI drivers. RCU/ @@ -101,7 +99,7 @@ clk.txt cma/ - Continuous Memory Area (CMA) debugfs interface. conf.py - - nothing here. Just a configuration file for Sphinx. + - It's not of interest for those who aren't touching the build system. connector/ - docs on the netlink based userspace<->kernel space communication mod. console/ @@ -403,9 +401,9 @@ sound/ spi/ - overview of Linux kernel Serial Peripheral Interface (SPI) support. sphinx/ - - no doumentation here, just files required by Sphinx toolchain. + - no documentation here, just files required by Sphinx toolchain. sphinx-static/ - - no doumentation here, just files required by Sphinx toolchain. + - no documentation here, just files required by Sphinx toolchain. static-keys.txt - info on how static keys allow debug code in hotpaths via patching svga.txt