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-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
