From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from atrey.karlin.mff.cuni.cz (atrey.karlin.mff.cuni.cz [195.113.26.193]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 424Pvx0cfSzF3HH for ; Tue, 4 Sep 2018 21:37:48 +1000 (AEST) Date: Tue, 4 Sep 2018 13:30:30 +0200 From: Pavel Machek To: Henrik Austad Cc: linux-doc@vger.kernel.org, Jonathan Corbet , Bjorn Helgaas , "Paul E. McKenney" , Josh Triplett , Steven Rostedt , 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: <20180904113030.GB25177@amd> References: <1536012923-16275-1-git-send-email-henrik@austad.us> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Fba/0zbH8Xs+Fj9o" In-Reply-To: <1536012923-16275-1-git-send-email-henrik@austad.us> List-Id: Linux on PowerPC Developers Mail List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , --Fba/0zbH8Xs+Fj9o Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi! > The 00-INDEX files are supposed to give a summary of all files present > in a directory, but these files are horribly out of date and their > usefulness is brought into question. Often a simple "ls" would reveal > the same information as the filenames are generally quite descriptive as > a short introduction to what the file covers (it should not surprise > -SAK.txt > - - info on Secure Attention Keys. > -SM501.txt > - - Silicon Motion SM501 multimedia companion chip > -btmrvl.txt > - - info on Marvell Bluetooth driver usage. Well, I don't know what sm501 is, but description helps me. SAK is similar. .. as is btmrvl. I'd say this is still quite valueable, and it might be worth fixing, rather then removing completely. And yes, moving stuff to subdirectories and naming files reasonably would help, too. "btmrvl" is really bad name... Pavel --=20 (english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blo= g.html --Fba/0zbH8Xs+Fj9o Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iEYEARECAAYFAluObNYACgkQMOfwapXb+vIEUgCfflpJ++Ke7RojgYEKLcv9wdCK VcAAoJ44RGl6/ZbjcSM3g58FnjCGx/f+ =c4sE -----END PGP SIGNATURE----- --Fba/0zbH8Xs+Fj9o--