Re: s3c24xx: Use devm_kcalloc() in s3c24xx_dma_probe()

From: Tobias Jakobi
Date: Sun Apr 23 2017 - 06:44:25 EST


SF Markus Elfring wrote:
>>> * A multiplication for the size determination of a memory allocation
>>> indicated that an array data structure should be processed.
>>> Thus use the corresponding function "devm_kcalloc".
>> I have trouble parsing that sentences. This looks like the typical
>> approach of native german speakers to directly transfer sentence
>> constructions from German to English. Which, in most cases, doesn't work
>> or is just plain confusing.
>
> Do you find the following wording better to understand
> if it would be presented by a script like âcheckpatch.plâ?
>
> WARNING: Prefer devm_kcalloc over devm_kzalloc with multiply
For example. Also I just noticed some previous comment by Krzysztof that
pointed that out already.

My suggestion: One sentence describing that the current situation is.
Another sentence explaining why this is bad/undesirable. Last sentence
saying what you're doing to fix this (can sometimes be omitted if it's
clear from the diffstat). In this case, the output of the checkpatch
script would come in handy.

With this, you avoid cramming every information into one long and
complicated sentence.

With best wishes,
Tobias


>
>
> Regards,
> Markus
>