Re: [PATCH v3 1/4] wifi: brcmfmac: Rename Cypress 89459 to BCM4355

[Hector Martin]

On 11/02/2023 20.23, Arend Van Spriel wrote:
> On February 11, 2023 11:09:02 AM Hector Martin <marcan@xxxxxxxxx> wrote:
> 
>> On 10/02/2023 12.42, Ping-Ke Shih wrote:
>>>
>>>
>>>> -----Original Message-----
>>>> From: Hector Martin <marcan@xxxxxxxxx>
>>>> Sent: Friday, February 10, 2023 10:50 AM
>>>> To: Arend van Spriel <aspriel@xxxxxxxxx>; Franky Lin 
>>>> <franky.lin@xxxxxxxxxxxx>; Hante Meuleman
>>>> <hante.meuleman@xxxxxxxxxxxx>; Kalle Valo <kvalo@xxxxxxxxxx>; David S. 
>>>> Miller <davem@xxxxxxxxxxxxx>; Eric
>>>> Dumazet <edumazet@xxxxxxxxxx>; Jakub Kicinski <kuba@xxxxxxxxxx>; Paolo 
>>>> Abeni <pabeni@xxxxxxxxxx>
>>>> Cc: Alexander Prutskov <alep@xxxxxxxxxxx>; Chi-Hsien Lin 
>>>> <chi-hsien.lin@xxxxxxxxxxx>; Wright Feng
>>>> <wright.feng@xxxxxxxxxxx>; Ian Lin <ian.lin@xxxxxxxxxxxx>; Soontak Lee 
>>>> <soontak.lee@xxxxxxxxxxx>; Joseph
>>>> chuang <jiac@xxxxxxxxxxx>; Sven Peter <sven@xxxxxxxxxxxxx>; Alyssa 
>>>> Rosenzweig <alyssa@xxxxxxxxxxxxx>;
>>>> Aditya Garg <gargaditya08@xxxxxxxx>; Jonas Gorski <jonas.gorski@xxxxxxxxx>; 
>>>> asahi@xxxxxxxxxxxxxxx;
>>>> linux-wireless@xxxxxxxxxxxxxxx; brcm80211-dev-list.pdl@xxxxxxxxxxxx; 
>>>> SHA-cyfmac-dev-list@xxxxxxxxxxxx;
>>>> netdev@xxxxxxxxxxxxxxx; linux-kernel@xxxxxxxxxxxxxxx; Hector Martin 
>>>> <marcan@xxxxxxxxx>; Arend van Spriel
>>>> <arend.vanspriel@xxxxxxxxxxxx>
>>>> Subject: [PATCH v3 1/4] wifi: brcmfmac: Rename Cypress 89459 to BCM4355
>>>>
>>>> The commit that introduced support for this chip incorrectly claimed it
>>>> is a Cypress-specific part, while in actuality it is just a variant of
>>>> BCM4355 silicon (as evidenced by the chip ID).
>>>>
>>>> The relationship between Cypress products and Broadcom products isn't
>>>> entirely clear but given what little information is available and prior
>>>> art in the driver, it seems the convention should be that originally
>>>> Broadcom parts should retain the Broadcom name.
>>>>
>>>> Thus, rename the relevant constants and firmware file. Also rename the
>>>> specific 89459 PCIe ID to BCM43596, which seems to be the original
>>>> subvariant name for this PCI ID (as defined in the out-of-tree bcmdhd
>>>> driver).
>>>>
>>>> v2: Since Cypress added this part and will presumably be providing
>>>> its supported firmware, we keep the CYW designation for this device.
>>>>
>>>> v3: Drop the RAW device ID in this commit. We don't do this for the
>>>> other chips since apparently some devices with them exist in the wild,
>>>> but there is already a 4355 entry with the Broadcom subvendor and WCC
>>>> firmware vendor, so adding a generic fallback to Cypress seems
>>>> redundant (no reason why a device would have the raw device ID *and* an
>>>> explicitly programmed subvendor).
>>>
>>> Do you really want to add changes of v2 and v3 to commit message? Or,
>>> just want to let reviewers know that? If latter one is what you want,
>>> move them after s-o-b with delimiter ---
>>
>> Both; I thought those things were worth mentioning in the commit message
>> as it stands on its own, and left the version tags in so reviewers know
>> when they were introduced.
> 
> The commit message is documenting what we end up with post reviewing so 
> patch versions are meaningless there. Of course useful information that 
> came up in review cycles should end up in the commit message.
> 

Do you really want me to respin this again just to remove 8 characters
from the commit message? I know it doesn't have much meaning post review
but it's not unheard of either, grep git logs and you'll find plenty of
examples.

- Hector