On Wed, Oct 18, 2023 at 09:32:46AM +0200, Karolina Stolarek wrote: > On 18.10.2023 09:03, Julia Lawall wrote: > > > > > > On Tue, 17 Oct 2023, kenechukwu maduechesi wrote: > > > > > Replace udelay() with usleep_range() for more precise delay handling. > > > > > > Reported by checkpatch: > > > > > > CHECK: usleep_range is preferred over udelay > > > > This message is typically not a good candidate for outreachy patches, > > because you need access to the device to be sure that any change is > > correct. > > Could we add a paragraph on how to pick good checkpatch.pl error to fix to > the Outreachyfirstpatch docs? This could go to "Find a driver to clean up" > section, for example. I think you should put a note about usleep_range() and the extra parentheses one. Also say something about looking up stuff on lore. https://lore.kernel.org/all/?q=sd_change_phase%20usleep_range In this case someone tried to update this before. The patch wasn't merged but it wasn't clearly explained to the developer why the patch wasn't merged. Ah well. Generally fresh warnings are better than old warnings because we fix the simple stuff where checkpatch is obviously correct. The other thing is that people really need to look at the wider context. Look at the surrounding code. Look at when the checkpatch warning was introduced and try to put yourself in the developer's head to figure out what they were thinking. Are there other opportunities for cleanups nearby. regards, dan carpenter
