From:   Thomas Gleixner <tglx@linutronix.de>
To:     Xiang wangx <wangxiang@cdjrlc.com>, john.stultz@linaro.org
Cc:     sboyd@kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH] time/timekeeping: Fix syntax errors in comments
In-Reply-To: <20211212143225.13727-1-wangxiang@cdjrlc.com>
References: <20211212143225.13727-1-wangxiang@cdjrlc.com>
Date:   Fri, 17 Dec 2021 23:26:52 +0100
Message-ID: <875yrmc1g3.ffs@tglx>
MIME-Version: 1.0
Content-Type: text/plain
Precedence: bulk

On Sun, Dec 12 2021 at 22:32, Xiang wangx wrote:
> Delete the redundant word 'time'.
>
> Signed-off-by: Xiang wangx <wangxiang@cdjrlc.com>
> ---
>  kernel/time/timekeeping.c | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/kernel/time/timekeeping.c b/kernel/time/timekeeping.c
> index b348749a9fc6..b1fbedd35300 100644
> --- a/kernel/time/timekeeping.c
> +++ b/kernel/time/timekeeping.c
> @@ -1148,7 +1148,7 @@ static int adjust_historical_crosststamp(struct system_time_snapshot *history,
>  			return ret;
>  	}
>  
> -	/* Fixup monotonic raw and real time time values */
> +	/* Fixup monotonic raw and real time values */

It's not redundant because it talks about 'time values'. The 'time
values' which are fixed up are 'monotonic raw' and 'real time'.

So yes, the comment _is_ awkward and hard to read, but removing time
does not make it any better. Something like this;

     /* Fixup the MONOTONIC_RAW and REAL_TIME time values */

Hmm?

Thanks,

        tglx