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

[Rob Landley]

On 01/31/14 16:24, Andrew Morton wrote:
> On Wed, 29 Jan 2014 22:24:11 -0600 Rob Landley <rob@xxxxxxxxxxx> 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@xxxxxxxxxxx>
>
> 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
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/