2022-05-05 09:39:59

by Bjorn Helgaas

[permalink] [raw]
Subject: Re: [PATCH] PCI: mediatek-gen3: change driver name to mtk-pcie-gen3

On Wed, May 04, 2022 at 12:05:55PM +0200, Felix Fietkau wrote:
> This allows it to coexist with the other mtk pcie driver in the same kernel

I assume this is a v3 of [1]. Please:

- Follow the subject line capitalization convention, i.e.,
"PCI: mediatek-gen3: Change ..."

- Expand the commit log to say why this is important. From a C
language level, using the same "mtk-pcie" string in both drivers
is no problem. So please mention where it *is* a problem, e.g.,
if it's a problem with modprobe or similar, say that. Or if it's
to make log messages in dmesg have different driver names, say
that.

- s/pcie/PCIe/ in commit log and other English text.

- Add a period at the end of the commit log sentence.

[1] https://lore.kernel.org/r/[email protected]

> Signed-off-by: Felix Fietkau <[email protected]>
> ---
> drivers/pci/controller/pcie-mediatek-gen3.c | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/drivers/pci/controller/pcie-mediatek-gen3.c b/drivers/pci/controller/pcie-mediatek-gen3.c
> index 3e8d70bfabc6..2e665cd7e735 100644
> --- a/drivers/pci/controller/pcie-mediatek-gen3.c
> +++ b/drivers/pci/controller/pcie-mediatek-gen3.c
> @@ -1021,7 +1021,7 @@ static struct platform_driver mtk_pcie_driver = {
> .probe = mtk_pcie_probe,
> .remove = mtk_pcie_remove,
> .driver = {
> - .name = "mtk-pcie",
> + .name = "mtk-pcie-gen3",
> .of_match_table = mtk_pcie_of_match,
> .pm = &mtk_pcie_pm_ops,
> },
> --
> 2.35.1
>
>
> _______________________________________________
> linux-arm-kernel mailing list
> [email protected]
> http://lists.infradead.org/mailman/listinfo/linux-arm-kernel


2022-05-09 02:12:57

by Felix Fietkau

[permalink] [raw]
Subject: Re: [PATCH] PCI: mediatek-gen3: change driver name to mtk-pcie-gen3


On 04.05.22 19:06, Bjorn Helgaas wrote:
> On Wed, May 04, 2022 at 12:05:55PM +0200, Felix Fietkau wrote:
>> This allows it to coexist with the other mtk pcie driver in the same kernel
>
> I assume this is a v3 of [1]. Please:
Thanks, I wasn't aware of that patch.

> - Follow the subject line capitalization convention, i.e.,
> "PCI: mediatek-gen3: Change ..."
>
> - Expand the commit log to say why this is important. From a C
> language level, using the same "mtk-pcie" string in both drivers
> is no problem. So please mention where it *is* a problem, e.g.,
> if it's a problem with modprobe or similar, say that. Or if it's
> to make log messages in dmesg have different driver names, say
> that.The reason is the fact that driver_register will refuse to register a
driver if one with the same name has already been registered.

> - s/pcie/PCIe/ in commit log and other English text.
>
> - Add a period at the end of the commit log sentence.
>
> [1] https://lore.kernel.org/r/[email protected]
Will take care of this and send an updated version as v3.

- Felix