linux-kernel - Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

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: <46BF44A6.7010401@s5r6.in-berlin.de>
Date:	Sun, 12 Aug 2007 19:34:30 +0200
From:	Stefan Richter <stefanr@...6.in-berlin.de>
To:	Jesper Juhl <jesper.juhl@...il.com>
CC:	linux-doc@...r.kernel.org, Rob Landley <rob@...dley.net>,
	Randy Dunlap <rdunlap@...otime.net>,
	Linux Kernel Mailing List <linux-kernel@...r.kernel.org>
Subject: Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

Jesper Juhl wrote:
> On 12/08/07, Stefan Richter <stefanr@...6.in-berlin.de> wrote:
>> Isn't it with 00-INDEX just like with the "Last Updated:" footers in
>> documentation texts?
>>
> That is certainly a risk, yes. But it shouldn't be hard to write a
> small script to check if the 00-INDEX files are up-to-date, that will
> make it pretty simple to update them once in a while if people forget.

Or use the first line of each text file to describe what the file is about.

And BTW, if authors insist on "Last Updated:", make it a header rather
than a footer.  Increases the chance that submitters remember to update it.
-- 
Stefan Richter
-=====-=-=== =--- -==--
http://arcgraph.de/sr/
-
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/