Re: Adding checkpointing API to Linux kernel

Michael Elizabeth Chastain (mec@shout.net)
Fri, 22 Jan 1999 12:04:35 -0600


Hi Steven,

> (hmmm... thinking I may have just voleentered :)

It's a dandelion problem -- you pull on it, and you find a whole root
system underneath it.

The problem is: "how do you document an entity where hundreds of unrelated
people check in code everywhere, and your desire for documentation
exceeds the willingness of those hundreds of people to write it."

When Linus decides he wants more documentation, he can make that a
criterion for accepting a patch. He can lay out whatever rules he likes.
My suggestion is: "if your code has an interface to userland, your patch
must have a file in Documentation/ somewhere that documents the interface
to userland."

Michael

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.rutgers.edu
Please read the FAQ at http://www.tux.org/lkml/