Re: [PATCH] ARC:mm:Fix syntax errors in comments
From: Bagas Sanjaya
Date: Wed Jun 22 2022 - 09:20:18 EST
On 6/22/22 16:38, Julia Lawall wrote:
>>> So code that is fine will have typos forever? Fixing typos in comments
>>> doesn't break git blame for the following code. And typos in comments
>>> give a bad impression about the state of the code in general.
>>
>> Of course not! Documentation is as important as the code, if not even more.
>> However, fixing typos to increase your commit counts to a reputable project
>> is not fine either. For instance, many of these proposed fixes are targeting
>> one single typo at a time. Couldn't they just be sent altogether!?!
>
> I have the impression that the person is just trying to figure out the
> patch submission process. For example, the subject lines are not
> formatter in the standard way (I sent the person a private email about
> that). Perhaps just let him know about how you would rather have received
> the patches.
In recent times I had seen many typofix patches sent to LKML. You can see most
of them by querying `s:"fix typo"` on lore.kernel.org. Some of these patches
have been merged, though.
What I say as starter thread is "ideal" scenario as described in
Documentation/process/2.Process.rst; that is we prefer to see these minor
fixes as part of real patches work (say refactoring), rather than just being
trivial patches.
But what most reviewers here missed is how these typos are found? I guess
these can be from codespell or some other tools, or even manual review,
then send the fixes en mass.
Take a look at "fix typo in a comment" aka "delete redundant word" patches
at [1], [2], [3]. and [4].
[1]: https://lore.kernel.org/lkml/20220618132659.17100-1-wangxiang@xxxxxxxxxx/
[2]: https://lore.kernel.org/lkml/20220618130349.11507-1-wangxiang@xxxxxxxxxx/
[3]: https://lore.kernel.org/lkml/20220616163830.11366-1-wangxiang@xxxxxxxxxx/
[4]: https://lore.kernel.org/lkml/20220606123419.29109-1-wangxiang@xxxxxxxxxx/
IMHO, these patches should have been in a single, consolidated patch, since
these strip duplicate (hence redundant) word (single logical change).
Thanks.
--
An old man doll... just what I always wanted! - Clara