Re: Updating 00-INDEX in Documentation/*

From: Henrik Austad
Date: Mon Nov 18 2013 - 19:04:20 EST


On Thu, Nov 14, 2013 at 11:09:03PM -0600, Rob Landley wrote:
> On 10/28/2013 08:05:11 AM, Henrik Austad wrote:
> >Hi Rob, Jiri
> >Hacking away at python shows me that of the 254 subfolders 57 has
> >outdated
> >00-INDEX, either with missing files, or files that has been
> >removed. (see
> >list below)
>
> I'm a bit behind on my email just now. (Started a new job last
> month, everything else got derailed for a bit.)
>
> >Now, I'm quite happy to start fixing this, but what I would like
> >to know
> >before I start:
> >
> >- is it considered a waste of time? i.e. will it be worth the time
> >- what is best, a single, big patch, or a series of one patch per
> > directory?
> >- or should someone(tm) kick whoever caused 00-INDEX to be
> >outdated, to fix
> > it?
>
> Go for it.

Ok, I'll work my way through the list then.

> I've had a script that does this since 2007, but it's in the context of
> creating html indexes for the kernel.org/doc/Documentation directory

Hmm, ok, I was just planning to get the 00-INDEX files up to speed,
anything beyond that was not on my plan.

> , and after the kernel.org breakin they never gave me rsync access back
> (because it's not built into git and all any server ever does is run git,
> right?) so I couldn't update it anymore. Then they decided that the
> Documentation directory should just be a raw checkout from git with no
> html indexes (because git), and presumably they'll be doing the same for
> http://kernel.org/doc/menuconfig any day now (how, I couldn't tell you,
> but it's apparently no longer my problem)...
>
> So it's kinda hard to get enthused about it these days. I wanted to
> revive my old push to reorganize the documentation directory
> (https://lkml.org/lkml/2007/5/22/473 and such) but if the word from
> on high is that a giant raw pile of unsorted files is the optimal
> way to organize things, who am I to argue?
>
> Same problem for kernel.org/doc/htmldocs: the ones I did way back when
> (https://web.archive.org/web/20090327025639/http://www.kernel.org/doc/htmldocs/)
> had both the "one big html file" version and the lots of little files
> version and I'd watch the build logs and send patches to get the warnings
> down, but they took that away and replaced it without even letting me
> know they were doing that, so I've fallen out of the habit. (My
> understanding was that the kernel.org guys officially don't care about
> any data that isn't accessed through git, and a web browser isn't git,
> so...)
>
> *shrug* I suppose all it's still on the todo list somewhere. Maybe
> somewhere after reviving http://landley.net/qemu and catching that
> up to current, but it's in there...
>
> Rob

--
Henrik Austad
--
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/