> IMHO, we wouldn't want to foster the impression that it's okay to > provide a non-determined effort, safe in the knowledge that someone > will come along later and finish the job for them at a later date. Right. The first lesson from that is that maintainers should require documentation of the fields when they get added. This was my oversight because it was back then not reported by checkers, probably. I am sorry. It annoys me, too. If I notice that someone updates a driver which doc-errors, then I ask if that could be fixed by this person, too. It usually works. Not for drivers without attention, of course. But this is why I don't mind doc-errors to stay. If this is considered problematic, then I'd suggest to remove the kernel doc headers like you did, but add a comment like: * FIXME: add missing fields and reenable kernel-doc To make sure, it is obvious even by glimpsing through the code that there is work needed. Can we agree on that?
Attachment:
signature.asc
Description: PGP signature