Messages in this thread | | | Date | Thu, 4 Dec 2008 00:10:32 +0000 | From | Alan Cox <> | Subject | Re: Yet more ARM breakage in linux-next |
| |
> For some reason, the act of typing in some kerneldoc makes people's > brains turn off. Perhaps it's because "oh, I am supposed to type some > documentation here" instead of "gee, I think this code is unclear, > let's clarify that".
Well prior to the kerneldoc stuff they didn't type anything at all to clarify or document. Also kerneldoc is meant for documenting the APIs not so much the internals of functions. When used sensibly it can be very useful, especially if it documents API locking rules.
Alan
| |