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

From: Rob Landley
Date: Sun Aug 12 2007 - 16:03:43 EST


On Sunday 12 August 2007 7:48:37 am Stefan Richter wrote:
> Isn't it with 00-INDEX just like with the "Last Updated:" footers in
> documentation texts?
>
> They are metadata which will be almost always out of date.

If nothing is using them, they'll bit-rot, yes. Way of the world. But I've
found a use for them. Therefore, I'm interested in getting them up to date
and then keeping them there. I already wrote an automatic checker to tell me
how they differ from reality, which is half the battle. (It won't help if
the file contents change so much the description needs to be updated, but
that's not a common event.)

Rob
--
"One of my most productive days was throwing away 1000 lines of code."
- Ken Thompson.
-
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/