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".
-- Andrew Morton
I personally don't like kerneldoc at all, because the truth is that
people will work on fixing bugs and other useful things before
keeping kerneldoc up to date.
And that's the basic fact which cannot be denied.
I wish it could work, but it doesn't across the board. So unless
we have dedicated monkeys scouring over every single patch that
goes into the tree and doing the necessary kerneldoc updates,
kerneldoc will be chronically wrong somewhere.
That leads to confusion and lost developer time. Because if the
kerneldoc bits are wrong, it's worthless.
-- David Miller
I expect better: You never see me hard with time word making
sentence coherent stuff. Ever.
-- Rusty Russell
As usual: You shall never rely on the source code comments, they
will only mislead you.
-- Manfred Spraul
to post comments)