Messages in this thread | | | Date | Tue, 23 Jan 2001 23:52:37 +1100 | From | Andrew Morton <> | Subject | Re: [OT?] Coding Style |
| |
Larry McVoy wrote: > > Please don't listen to this. The only place you really want comments is > > a) at the top of files, describing the point of the file; > b) at the top of functions, if the purpose of the function is not obvious; > c) in line, when the code is not obvious.
One other _very_ useful place: in header files. This is a place where a comment-per-line is appropriate.
For example, include/linux/fs.h. Shame about `struct inode' though.
- - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org Please read the FAQ at http://www.tux.org/lkml/
| |