lkml.org 
[lkml]   [2014]   [Feb]   [2]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH] Documentation cleanup, update 00-INDEX files in Documentation/
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


\
 
 \ /
  Last update: 2014-02-02 08:41    [W:0.079 / U:1.432 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site