From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 425ld80W6PzF3Rr for ; Fri, 7 Sep 2018 01:59:36 +1000 (AEST) Date: Thu, 6 Sep 2018 09:58:04 -0600 From: Jonathan Corbet To: Steven Rostedt Cc: Pavel Machek , Henrik Austad , linux-doc@vger.kernel.org, Bjorn Helgaas , "Paul E. McKenney" , Josh Triplett , Mathieu Desnoyers , Lai Jiangshan , Jens Axboe , Rob Herring , Mark Rutland , Bartlomiej Zolnierkiewicz , Linus Walleij , "David S. Miller" , Karsten Keil , Masahiro Yamada , Michal Marek , Peter Zijlstra , Ingo Molnar , Will Deacon , Ralf Baechle , Paul Burton , James Hogan , Paul Moore , "James E.J. Bottomley" , Helge Deller , "Rafael J. Wysocki" , Len Brown , Benjamin Herrenschmidt , Paul Mackerras , Michael Ellerman , Martin Schwidefsky , Heiko Carstens , Greg Kroah-Hartman , Jiri Slaby , Mark Brown , Thomas Gleixner , Paolo Bonzini , Radim =?UTF-8?B?S3LEjW3DocWZ?= , Evgeniy Polyakov , "H. Peter Anvin" , x86@kernel.org, Andrew Morton , Ian Kent , Jacek Anaszewski , Mike Rapoport , Jan Kandziora , linux-kernel@vger.kernel.org, linux-pci@vger.kernel.org, devicetree@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-fbdev@vger.kernel.org, linux-gpio@vger.kernel.org, linux-ide@vger.kernel.org, netdev@vger.kernel.org, linux-kbuild@vger.kernel.org, linux-mips@linux-mips.org, linux-security-module@vger.kernel.org, linux-parisc@vger.kernel.org, linux-pm@vger.kernel.org, linuxppc-dev@lists.ozlabs.org, linux-s390@vger.kernel.org, linux-spi@vger.kernel.org, kvm@vger.kernel.org, Henrik Austad Subject: Re: [PATCH] [RFC v2] Drop all 00-INDEX files from Documentation/ Message-ID: <20180906095804.5ab2716f@lwn.net> In-Reply-To: <20180904095908.13298b3d@gandalf.local.home> References: <1536012923-16275-1-git-send-email-henrik@austad.us> <20180904113030.GB25177@amd> <20180904095908.13298b3d@gandalf.local.home> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII List-Id: Linux on PowerPC Developers Mail List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , On Tue, 4 Sep 2018 09:59:08 -0400 Steven Rostedt wrote: > On Tue, 4 Sep 2018 13:30:30 +0200 > Pavel Machek wrote: > > > I'd say this is still quite valueable, and it might be worth fixing, > > rather then removing completely. > > I agree. Perhaps we should have a 00-DESCRIPTION file in each > directory, and each file could start with a: > > DESCRIPTION: > > and then these files could be generated by those that have these tags. I really don't want to hack up yet another documentation syntax and processing scheme. We already have one that does all of this and more. That energy would be far better spent bringing the docs into the RST hierarchy, IMO. Thanks, jon (who is increasingly inclined to apply this patch)