From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail.manjaro.org (mail.manjaro.org [116.203.91.91]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0DE5E4A28; Sat, 18 Jan 2025 10:45:11 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=116.203.91.91 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1737197114; cv=none; b=aChxv4JtMpHOVZLhiffPbIZX+BAZWoIqJ89nMB7zB/6wYW6umzF0Oxs6ZxA2jaS5uX4r+i2YgJiG7V5O4dAH0hfk31gLeR2V6El0VIth4g4NB++UMSuuXvhsUkr7zCna3LMdIU6HlubEaNKruLdWpuaTClL3GLWHynBwFt7BkXM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1737197114; c=relaxed/simple; bh=9S8uMZ1pzuObsoJFQudO04vFkKOv9e4oYNUEMNM89fs=; h=MIME-Version:Date:From:To:Cc:Subject:In-Reply-To:References: Message-ID:Content-Type; b=e8K1zKdygsddmi2g69C94H5VeGG62A7vl9X13Mza/bkmuDUKt3OuQqzyS0s5oFdqutll0XUfWgUWzWO1Y+Ic9nvU3N4qjgEgcB3FYcaxNLyx2M4zLiGz060K4MwNr+bslfQDZgIH6d+SAymMA1znSHkbyEF/dgMq7MiNEVgF97Q= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=manjaro.org; spf=pass smtp.mailfrom=manjaro.org; dkim=pass (2048-bit key) header.d=manjaro.org header.i=@manjaro.org header.b=WbQcZrzA; arc=none smtp.client-ip=116.203.91.91 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=manjaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=manjaro.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=manjaro.org header.i=@manjaro.org header.b="WbQcZrzA" Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=manjaro.org; s=2021; t=1737197109; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=606ILteB7IisYDccr+k/oifxwQd4pmlbPg2zqcDE8Qo=; b=WbQcZrzAc+4M+XXOz2uL+sEWs4m5CWvK0XUhsbNu09C5GFW1/1ncBkqIgmr2mS4BbmHcc8 1bPbKFTVEw3TRzffajLD4Co+nXSwswUI5c/vguSdFbhBNb/mXtSKX82ynsZq3Dmycz9cUO CGMdVLwuBYPxry6SEhCNzFgXYSfx1UkjxwNqg+yj0FEbTL/9TkX+Vwoa0qhLC4mdRskbHr 5Y1EfLkt+VlIYPmzOTWcW84y9J9GbW6kzbuPq8e/iEdsXJcnahEv0uiRcU+A05Tu8PuZJ3 S6uMBF/RGk5W8r0yAae9GEHMdmTKbTEnfjPDS5VzW30MSWFeZyk07eihpxYOpQ== Date: Sat, 18 Jan 2025 11:45:08 +0100 From: Dragan Simic To: Krzysztof Kozlowski Cc: Diederik de Haas , Peter Geis , Heiko Stuebner , zyw@rock-chips.com, kever.yang@rock-chips.com, frank.wang@rock-chips.com, william.wu@rock-chips.com, wulf@rock-chips.com, linux-rockchip@lists.infradead.org, Alex Bee , Conor Dooley , Johan Jonker , Jonas Karlman , Krzysztof Kozlowski , Rob Herring , devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: Re: [RFC PATCH v1 4/6] arm64: dts: rockchip: add rk3328 usb3 phy node In-Reply-To: References: <20250115012628.1035928-1-pgwipeout@gmail.com> <20250115012628.1035928-5-pgwipeout@gmail.com> <7c7ce820-8a9b-46df-b143-f77835b7e5a0@kernel.org> <1bc91b4214a1099801aaed6b3ef81ef3@manjaro.org> <60ced7df829e7c10e264627cc0947762@manjaro.org> <20b474be-301e-4dc3-9eb7-77e9ef075191@kernel.org> <3d9ce9fd9b6309553b5669e111bc4200@manjaro.org> <735d89df-9954-44bd-aca6-4bb165737626@kernel.org> <7ab853de15e1c183ef184d2700a13d98@manjaro.org> Message-ID: X-Sender: dsimic@manjaro.org Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit Authentication-Results: ORIGINATING; auth=pass smtp.auth=dsimic@manjaro.org smtp.mailfrom=dsimic@manjaro.org On 2025-01-18 11:29, Krzysztof Kozlowski wrote: > On 18/01/2025 11:10, Dragan Simic wrote: >> On 2025-01-18 10:52, Krzysztof Kozlowski wrote: >>> On 18/01/2025 10:43, Dragan Simic wrote: >>>>>> >>>>>> Please see the commit bdc48fa11e46 (checkpatch/coding-style: >>>>>> deprecate >>>>>> 80-column warning, 2020-05-29), which clearly shows that the >>>>>> 80-column >>>>>> rule is still _preferred_, but no longer _mandatory_. >>>>> >>>>> I brought that commit, but nice that you also found it. >>>>> >>>>> Still: read the coding style, not checkpatch tool. >>>>> >>>>>>>> 80 columns is really not much (for the record, I've been around >>>>>>>> when >>>>>>>> using 80x25 _physical_ CRT screens was the norm). >>>>>>> >>>>>>> You mistake agreement on dropping strong restriction in 2020 in >>>>>>> checkpatch, which is "not for years" and even read that commit: >>>>>>> "Yes, >>>>>>> staying withing 80 columns is certainly still _preferred_." >>>>>>> >>>>>>> Checkpatch is not coding style. Since when it would be? It's just >>>>>>> a >>>>>>> tool. >>>>>>> >>>>>>> And there were more talks and the 80-preference got relaxed yet >>>>>>> still >>>>>>> "not for years" (last talk was 2022?) and sill kernel coding >>>>>>> style >>>>>>> is >>>>>>> here specific. >>>>>> >>>>>> It's perhaps again about the semantics, this time about the >>>>>> meaning >>>>>> of "for years". I don't think there's some strict definition of >>>>>> that >>>>>> term, so perhaps different people see it differently. >>>>>> >>>>>> To get back to the above-mentioned commit bdc48fa11e46, the >>>>>> 80-column >>>>>> limit has obviously been lifted, putting the new 100-column limit >>>>>> as >>>>> >>>>> "Lifted" on *CHECKPATCH*, not on coding style. Do you see the >>> >>> Repeating myself about because you are not addressing the actual >>> difference. >> >> Please see below. >> >>>>> difference? One is a helper tool which people were using blindly >>>>> and >>>>> wrapping lines without thinking, claiming that checkpatch told them >>>>> to >>>>> do so. Other is the actual coding style. >>>>> >>>>> You claim that coding style was changed. This never happened. >>>> >>>> It was obviously changed in the commit bdc48fa11e46, by making the >>>> 80-column width preferred, instead of if being mandatory. The way >>>> I read the changes to the coding style introduced in that commit, >>>> it's now possible to go over 80 columns, up to 100 columns, _if_ >>>> that actually improves the readability of the source code. >>> >>> The commit is for checkpatch. Point to the change in coding style. >>> You >>> are bringing argument for checkpatch, so only a tool, as argument for >>> coding style. Again, coding style did not change since years. >> >> Commit bdc48fa11e46 obviously addresses >> Documentation/process/coding-style.rst >> as well, as visible in the quotation from the commit below: > > Yes. > >> >> -The limit on the length of lines is 80 columns and this is a >> strongly > > 80 is here... > >> -preferred limit. >> - >> -Statements longer than 80 columns will be broken into sensible >> chunks, unless >> -exceeding 80 columns significantly increases readability and does >> not >> hide >> -information. Descendants are always substantially shorter than the >> parent and >> -are placed substantially to the right. The same applies to >> function >> headers >> -with a long argument list. However, never break user-visible >> strings >> such as >> -printk messages, because that breaks the ability to grep for them. >> +The preferred limit on the length of a single line is 80 columns. >> + >> +Statements longer than 80 columns should be broken into sensible > > 80 is here as well. > > So now to your original statement: > " but the 100-column limit > for the kernel code has been in effect for years." > > Where is 100? Only in checkpatch. There is no 100 limit in kernel > coding > style. Yes, "100" is in checkpatch only, but the coding style explicitly says that going over the 80-column limit it fine if it improves the readability. Thus, going over the 80 columns has been allowed "for years", whatever one finds that term to mean, or more precisely since mid-2020, and having "100" present in checkpatch establishes "100" as the effective "hard" limit. > The change in coding style and checkpatch was partially done because of > your understanding: reading checkpatch output as a rule. But this was > never a correct approach and still is not. So whatever checkpatch is > telling you, e.g. "100 column limit", is not coding style. It's only > checkpatch, a tool trying to help you. No, that isn't my understanding. I don't take checkpatch's output as some kind of mandatory rules; however, what checkpatch does and suggests should be based on the coding style, and if checkpatch advises wrongly, it should be fixed instead of being accused to be invalid and pointless. Though, in this particular case, checkpatch does it right. The coding style explicitly says that going over the 80-column limit is fine if that improves the readability, and checkpatch follows that by allowing up to 100 columns. >> chunks, >> +unless exceeding 80 columns significantly increases readability >> and >> does >> +not hide information. >> + >> +Descendants are always substantially shorter than the parent and >> are >> +are placed substantially to the right. A very commonly used style >> +is to align descendants to a function open parenthesis. >> + >> +These same rules are applied to function headers with a long >> argument >> list. >> + >> +However, never break user-visible strings such as printk messages >> because >> +that breaks the ability to grep for them. >> >> I think it's obvious that the 80-column width is no longer _strongly_ >> preferred, but has been demoted to some kind of a bit weaker >> preference. > > Yes, but this is not what you said before and this is not what I > questioned. It is, if you read what I wrote above carefully. The 100-column width limit has been in effect "for years", and has been defined by the combination of the coding style and checkpatch. The former says that going over 80 columns is fine, and the latter limits that to 100 columns, to prevent some very long lines. >> Also, please note that the coding style explicitly says that the 80- >> column rule is to be followed "unless exceeding 80 columns >> significantly >> increases readability and does not hide information". > > I already said it earlier... so yeah, we keep repeating ourselves while > discussing original point claiming now something else than we actually > discuss. I think it's again about the semantics. :) Please see above.