linux-kernel - Re: Updating 00-INDEX in Documentation/*

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <alpine.LNX.2.00.1310301420240.21144@pobox.suse.cz>
Date:	Wed, 30 Oct 2013 14:21:56 +0100 (CET)
From:	Jiri Kosina <jkosina@...e.cz>
To:	Henrik Austad <henrik@...tad.us>
Cc:	Rob Landley <rob@...dley.net>, linux-doc@...r.kernel.org,
	linux-kernel@...r.kernel.org
Subject: Re: Updating 00-INDEX in Documentation/*

On Mon, 28 Oct 2013, Henrik Austad wrote:

> Hi Rob, Jiri
> 
> If this email goes the wrong place, my sincere apologies, my asbestos 
> underwear can be quickly donned!
> 
> I've been reading through some of the docs and one thing that has struct 
> me, is that there is a certain degree of bitrot (textrot?). Almost every 
> category has an outdated 00-INDEX. A couple of indexes has been updated 
> (thanks for applying Jiri!), but more remains.
> 
> This is obviously not the most important job to undertake, but it 
> serves as a very convenient starting-point when exploring a given topic.
> 
> 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)
> 
> 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

That definitely depends purely on you, as you are the sole owner of your 
own time :)

I'd be happy to apply the fixes if you decide to produce them, as keeping 
the references broken isn't really nice.

> - what is best, a single, big patch, or a series of one patch per 
>   directory?

For this particular thing, I'd prefer single big patch. I can handle the 
(very unlikely) conflict cases.

> - or should someone(tm) kick whoever caused 00-INDEX to be outdated, to fix 
>   it?

That's probably more effort than actually fixing it :)

Thanks,

-- 
Jiri Kosina
SUSE Labs
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/