--- linux-2.5.1-pre7/Documentation/CodingStyle	Sun Sep  9 16:40:43 2001
+++ linux/Documentation/CodingStyle	Sat Dec  8 17:54:50 2001
@@ -142,6 +142,12 @@
 it's performance-critical, and it will probably do a better job of it
 that you would have done). 
 
+In header files, use simple descriptive names for parameters of
+functions and function pointers when the meaning of a parameter is
+not absolutely postively clear.  This probably includes every
+parameter of type "int."  This is an easy and quickly accessible
+form of interface documentation.
+
 Another measure of the function is the number of local variables.  They
 shouldn't exceed 5-10, or you're doing something wrong.  Re-think the
 function, and split it into smaller pieces.  A human brain can