Re: [PATCH] Documentation cleanup, update 00-INDEX files in Documentation/

From: Rob Landley <rob@landley.net>
To: Andrew Morton <akpm@linux-foundation.org>
Cc: Henrik Austad <henrik@austad.us>,
	LKML doc <linux-doc@vger.kernel.org>,
	LKML <linux-kernel@vger.kernel.org>,
	Jiri Kosina <jkosina@suse.cz>,
	"Paul E. McKenney" <paulmck@linux.vnet.ibm.com>,
	Thomas Gleixner <tglx@linutronix.de>,
	Rob Herring <robh+dt@kernel.org>,
	"David S. Miller" <davem@davemloft.net>,
	Mark Brown <broonie@kernel.org>, "H. Peter Anvin" <hpa@zytor.com>,
	Ingo Molnar <mingo@elte.hu>, Gleb Natapov <gleb@kernel.org>,
	Linus Torvalds <torvalds@linux-foundation.org>,
	Len Brown <len.brown@intel.com>,
	James Bottomley <JBottomley@parallels.com>,
	Jean-Christophe Plagniol-Villard <plagnioj@jcrosoft.com>
Subject: Re: [PATCH] Documentation cleanup, update 00-INDEX files in Documentation/
Date: Sun, 02 Feb 2014 01:04:55 -0600	[thread overview]
Message-ID: <52EDEE17.4010205@landley.net> (raw)
In-Reply-To: <20140131142442.8030cf06d1d729c8e3a4541c@linux-foundation.org>

On 01/31/14 16:24, Andrew Morton wrote:
> On Wed, 29 Jan 2014 22:24:11 -0600 Rob Landley <rob@landley.net> wrote:
>
>> On 01/29/14 18:27, Henrik Austad wrote:
>>> Some of the 00-INDEX files are somewhat outdated and some folders does not
>>> contain 00-INDEX at all. Only outdated (with the notably exception of
>>> spi) indexes are touched here, the 169 folders without 00-INDEX has not
>>> been touched.
>>>
>>> This applies to Linus' tip (0e47c969).
>>
>> Looks like an improvement.
>>
>> Acked-by: Rob Landley <rob@landley.net>
>
> Are these 00-INDEX files actually useful?  I've never opened one of
> them in my life.

Back before kernel.org did its epic barn door locking after the horses 
escaped, I used to use them to generate HTML indexes for 
kernel.org/doc/Documentation, but sometime after they took away my 
ability to rsync updates to that they replaced that directory with a raw 
git checkout. I'm still waiting for them to replace the HTML versions of 
the menuconfig help text and the htmldocs output with raw git checkouts too.

I periodically poke them about it, ala 
https://bugzilla.kernel.org/show_bug.cgi?id=52721#c7 but the answer is 
always crickets chirping or "you should upload web pages with git just 
like you browse the web with git, watch video with git, play skyrim with 
git, edit code with git, compile code with git... there is no other 
software tool." At which point I wander off for another 6 months.

So I used to have a use for it, but since kernel.org got all paranoid I 
can't use it that way anymore. (That's why I haven't been updating these 
files when the patches themselves don't. It's on my todo list, but it's 
really hard to _care_ when they so obviously don't.)

Insufficiently gruntled,

Rob