On Sat, 20 Jul 2002, Linus Torvalds wrote:
> Good. I hate the fact that so many people seem to think that adding 15
> lines of copyright notice to a file somehow makes it "more legal". All it
> does is to give some corporate lawyer a bone, and take up precious
> real-estate on the first thing you see when you open the file that could
> be used to actually say what the file does (and who has worked on it).
On a related note, it would be nice if files had a one-
(or two-)line description near the top saying what the
code in this file is supposed to do.
That should cut down on the time people spend searching the
kernel for code and maybe even reduce code duplication...
Would a series of small documentation patches adding small
descriptions to the top of files be welcome ?
regards,
Rik
-- Bravely reimplemented by the knights who say "NIH".http://www.surriel.com/ http://distro.conectiva.com/
- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
This archive was generated by hypermail 2b29 : Tue Jul 23 2002 - 22:00:34 EST