Re: [OT?] Coding Style

Andrew Morton
2001-01-23T12:45:22Z

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.