Re: [patch] eventfd - revised interface and cleanups (2nd rev)

From: Davide Libenzi
Date: Tue Jun 23 2009 - 17:41:32 EST

On Tue, 23 Jun 2009, Andrew Morton wrote:

> > Should functions be describing all the returned error codes, ala man pages?
> >
> I think so.

This becomes pretty painful when the function calls other functions, for
which just relays the error code.
Should we be just documenting the error codes introduced by the function
code, and say that the function returns errors A, B, C plus all the ones
returned by the called functions X, Y, Z?
If not, it becomes hell in maintaining the comments...

- Davide

To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at
Please read the FAQ at