Thread (27 messages) 27 messages, 3 authors, 2015-03-09

Re: [PATCH v5 3/8] pinctrl: cygnus: add initial IOMUX driver support

From: Paul Bolle <hidden>
Date: 2015-03-09 19:30:49
Also in: linux-arm-kernel, linux-gpio, lkml

Ray Jui schreef op ma 09-03-2015 om 12:00 [-0700]:
I think it depends on how you see it. Based on this logic, then one can
also argue comments in the code will be pre-processed away and are not
needed. They at least serve the same documentation purpose in a way.
So why not make them comments? And even that might not be needed:
- MODULE_LICENSE() only summarizes, in just a few words, what takes a
few paragraphs in the customary comment at the top of a file;
- MODULE_DESCRIPTION() repeats what, in general, has been said in the
Kconfig entry for that driver and in the git commit explanation;
- and I'm not sure what the benefit is of MODULE_AUTHOR() in the first
place (even for actually modular drivers).
So
far I haven't seen other people complaining that having these module
based macros in the driver are confusing when the Kconfig has a bool.
Perhaps that's just because review doesn't spot all issues. Patch
bandwidth exceeding review bandwidth and all that.

Anyhow, right now there's another thread discussing the questions my
review comments raise. Eg, "The Kconfig symbol is bool, there is module
related code in the driver, why note make the Kconfig symbol tristate
(and the driver modular)?". I think that is one of the questions mixing
built-in and modular semantics raises.


Paul Bolle
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help