Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753444AbcLFMlm (ORCPT ); Tue, 6 Dec 2016 07:41:42 -0500 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:50075 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1753398AbcLFMlg (ORCPT ); Tue, 6 Dec 2016 07:41:36 -0500 Date: Tue, 6 Dec 2016 10:41:26 -0200 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , LKML , Brian Norris Subject: Re: [PATCH 5/5] docs: 00-INDEX: document directories/files with no docs Message-ID: <20161206104126.5a3eaa99@vento.lan> In-Reply-To: <20161205142540.00aaac51@lwn.net> References: <1a392f2336c5a0421a08fd316e01ca17bb9457d5.1480937715.git.mchehab@s-opensource.com> <20161205142540.00aaac51@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: 4039 Lines: 128 Em Mon, 5 Dec 2016 14:25:40 -0700 Jonathan Corbet escreveu: > On Mon, 5 Dec 2016 09:41:45 -0200 > Mauro Carvalho Chehab wrote: > > > There are a number of files/directories that don't contain > > any documentation. They're related to ReST file conversion. > > > > As a matter of completeness, since Makefile is also documented > > there, add an entry for those files too. > > As promised, a couple of quibbles... > > > Signed-off-by: Mauro Carvalho Chehab > > --- > > Documentation/00-INDEX | 19 +++++++++++++++++++ > > 1 file changed, 19 insertions(+) > > > > diff --git a/Documentation/00-INDEX b/Documentation/00-INDEX > > index 272f5c4481f1..6d488509285d 100644 > > --- a/Documentation/00-INDEX > > +++ b/Documentation/00-INDEX > > @@ -14,6 +14,8 @@ Following translations are available on the WWW: > > - this file. > > ABI/ > > - info on kernel <-> userspace ABI and relative interface stability. > > +CodingStyle > > + - nothing here, just a pointer to process/coding-style.rst. > > DMA-API.txt > > - DMA API, pci_ API & extensions for non-consistent memory machines. > > DMA-API-HOWTO.txt > > @@ -39,6 +41,9 @@ Intel-IOMMU.txt > > Makefile > > - This file does nothing. Removing it breaks make htmldocs and > > make distclean. > > +Makefile.sphinx > > + - This file does nothing. Removing it breaks make htmldocs and > > + make distclean. > > To say that this file "does nothing" is clearly incorrect - it controls how > the sphinx build is done. Basically, I repeated the same text as the one for Makefile. I'll send a patch changing both texts ;) > > > PCI/ > > - info related to PCI drivers. > > RCU/ > > @@ -47,6 +52,8 @@ SAK.txt > > - info on Secure Attention Keys. > > SM501.txt > > - Silicon Motion SM501 multimedia companion chip > > +SubmittingPatches > > + - nothing here, just a pointer to process/coding-style.rst. > > accounting/ > > - documentation on accounting and taskstats. > > acpi/ > > @@ -93,6 +100,8 @@ clk.txt > > - info on the common clock framework > > cma/ > > - Continuous Memory Area (CMA) debugfs interface. > > +conf.py > > + - nothing here. Just a configuration file for Sphinx. > > Again, it's not "nothing"; we could say it's not of interest to people who > aren't doing things with the build system. Ok. > > > connector/ > > - docs on the netlink based userspace<->kernel space communication mod. > > console/ > > @@ -135,6 +144,8 @@ digsig.txt > > -info on the Digital Signature Verification API > > dma-buf-sharing.txt > > - the DMA Buffer Sharing API Guide > > +docutils.conf > > + - nothing here. Just a configuration file for docutils. > > dontdiff > > - file containing a list of files that should never be diff'ed. > > driver-api/ > > @@ -201,6 +212,8 @@ ide/ > > - Information regarding the Enhanced IDE drive. > > iio/ > > - info on industrial IIO configfs support. > > +index.rst > > + - main index for the documentation at ReST format. > > infiniband/ > > - directory with documents concerning Linux InfiniBand support. > > input/ > > @@ -307,6 +320,8 @@ nvdimm/ > > - info on non-volatile devices. > > nvmem/ > > - info on non volatile memory framework. > > +output/ > > + - default directory where html/LaTeX/pdf files will be written. > > padata.txt > > - An introduction to the "padata" parallel execution API > > parisc/ > > @@ -387,6 +402,10 @@ sound/ > > - directory with info on sound card support. > > spi/ > > - overview of Linux kernel Serial Peripheral Interface (SPI) support. > > +sphinx/ > > + - no doumentation here, just files required by Sphinx toolchain. > > Indeed there's no "doumentation" there :) No documentation either. Heh ;) I'll fix the typo. > > > +sphinx-static/ > > + - no doumentation here, just files required by Sphinx toolchain. > > static-keys.txt > > - info on how static keys allow debug code in hotpaths via patching > > svga.txt > > Thanks, > > jon Thanks, Mauro