Re: [PATCH v3] checkpatch: add warning for lines starting with a '#' in commit log

From: Joe Perches
Date: Wed Dec 02 2020 - 16:04:21 EST


On Thu, 2020-12-03 at 02:27 +0530, Dwaipayan Ray wrote:
> Commit log lines starting with '#' are dropped by git as comments.
> Add a check to emit a warning for these lines.
>
> Also add a --fix option to insert a space before the leading '#' in
> such lines.
>
> Suggested-by: Joe Perches <joe@xxxxxxxxxxx>
> Suggested-by: Peilin Ye <yepeilin.cs@xxxxxxxxx>
> Tested-by: Peilin Ye <yepeilin.cs@xxxxxxxxx>
> Signed-off-by: Dwaipayan Ray <dwaipayanray1@xxxxxxxxx>

Acked-by: Joe Perches <joe@xxxxxxxxxxx>

> ---
> Changes in v3:
> - Modify commit message for more clarity
> - Modify warning message
> - Modify --fix option to substitute single space instead of tab
>
> Changes in v2:
> - Modify warning message and type
> - Style fixes
>
>  scripts/checkpatch.pl | 9 +++++++++
>  1 file changed, 9 insertions(+)
>
> diff --git a/scripts/checkpatch.pl b/scripts/checkpatch.pl
> index e8c1ed0b1fad..7940889877ba 100755
> --- a/scripts/checkpatch.pl
> +++ b/scripts/checkpatch.pl
> @@ -2966,6 +2966,15 @@ sub process {
>   $commit_log_possible_stack_dump = 0;
>   }
>  
>
> +# Check for lines starting with a #
> + if ($in_commit_log && $line =~ /^#/) {
> + if (WARN("COMMIT_COMMENT_SYMBOL",
> + "Commit log lines starting with '#' are dropped by git as comments\n" . $herecurr) &&
> + $fix) {
> + $fixed[$fixlinenr] =~ s/^/ /;
> + }
> + }
> +
>  # Check for git id commit length and improperly formed commit descriptions
>   if ($in_commit_log && !$commit_log_possible_stack_dump &&
>   $line !~ /^\s*(?:Link|Patchwork|http|https|BugLink|base-commit):/i &&