From: Sui Jingfeng <15330273260@189.cn>
To: WANG Xuerui <kernel@xen0n.name>,
Maarten Lankhorst <maarten.lankhorst@linux.intel.com>,
Maxime Ripard <mripard@kernel.org>,
Thomas Zimmermann <tzimmermann@suse.de>,
David Airlie <airlied@gmail.com>, Daniel Vetter <daniel@ffwll.ch>,
Li Yi <liyi@loongson.cn>, Sumit Semwal <sumit.semwal@linaro.org>,
Christian Koenig <christian.koenig@amd.com>,
Emil Velikov <emil.l.velikov@gmail.com>
Cc: linaro-mm-sig@lists.linaro.org,
loongson-kernel@lists.loongnix.cn,
Geert Uytterhoeven <geert+renesas@glider.be>,
linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org,
Javier Martinez Canillas <javierm@redhat.com>,
Nathan Chancellor <nathan@kernel.org>,
Liu Peibao <liupeibao@loongson.cn>,
linux-media@vger.kernel.org
Subject: Re: [PATCH v14 1/2] drm: add kms driver for loongson display controller
Date: Thu, 25 May 2023 12:14:17 +0800 [thread overview]
Message-ID: <5f70f46b-8c53-c55b-761a-6bb50c01b2b1@189.cn> (raw)
In-Reply-To: <04ede1b1-9757-5181-eec7-658c1df0480e@189.cn>
On 2023/5/25 12:09, Sui Jingfeng wrote:
> Hi,
>
> On 2023/5/23 00:40, WANG Xuerui wrote:
>> On 5/22/23 21:13, Sui Jingfeng wrote:
>>> Hi,
>>>
>>> On 2023/5/22 18:25, WANG Xuerui wrote:
>>>> On 2023/5/22 18:17, Sui Jingfeng wrote:
>>>>> Hi,
>>>>>
>>>>> On 2023/5/22 18:05, WANG Xuerui wrote:
>>>>>> On 2023/5/22 17:49, Sui Jingfeng wrote:
>>>>>>> Hi,
>>>>>>>
>>>>>>> On 2023/5/22 17:28, WANG Xuerui wrote:
>>>>>>>> On 2023/5/22 17:25, Sui Jingfeng wrote:
>>>>>>>>> Hi,
>>>>>>>>>
>>>>>>>>> On 2023/5/21 20:21, WANG Xuerui wrote:
>>>>>>>>>>> + * LS3A4000/LS3A5000/LS3A6000 CPU, they are equipped with
>>>>>>>>>>> on-board video RAM
>>>>>>>>>>> + * typically. While LS2K0500/LS2K1000/LS2K2000 are low cost
>>>>>>>>>>> SoCs which share
>>>>>>>>>>> + * the system RAM as video RAM, they don't has a dediacated
>>>>>>>>>>> VRAM.
>>>>>>>>>>
>>>>>>>>>> CPU models are not typically prefixed with "LS", so "Loongson
>>>>>>>>>> 3A4000/3A5000/3A6000".
>>>>>>>>>>
>>>>>>>>> Here is because when you do programming, variable name should
>>>>>>>>> prefix with letters.
>>>>>>>>
>>>>>>>> Commit messages, comments, and log messages etc. are natural
>>>>>>>> language, so it's better to treat them differently. No problem
>>>>>>>> to keep code as-is IMO.
>>>>>>>>
>>>>>>> Then you get two name for a single chip, take LS7A1000 as an
>>>>>>> example.
>>>>>>>
>>>>>>> You name it as Loongson 7A1000 in commit message, and then you
>>>>>>> have to define another name in the code, say LS7A1000.
>>>>>>>
>>>>>>> "Loongson 7A1000" is too long, not as compact as LS7A1000.
>>>>>>>
>>>>>>> This also avoid bind the company name to a specific product,
>>>>>>> because a company can produce many product.
>>>>>>
>>>>>> Nah, the existing convention is "LS7Xxxxx" for bridges and
>>>>>> "Loongson 3Axxxx" for CPUs (SoCs like 2K fall under this category
>>>>>> too). It's better to stick with existing practice so it would be
>>>>>> familiar to long-time Loongson/LoongArch developers, but I
>>>>>> personally don't think it will hamper understanding if you feel
>>>>>> like doing otherwise.
>>>>>>
>>>>> Can you explain why it is better?
>>>>>
>>>>> is it that the already existing is better ?
>>>>
>>>> It's not about subjective perception of "better" or "worse", but
>>>> about tree-wide consistency, and about reducing any potential
>>>> confusion from newcomers. I remember Huacai once pointing out that
>>>> outsiders usually have a hard time remembering "1, 2, and 3 are
>>>> CPUs, some 2 are SoCs, 7 are bridge chips", and consistently
>>>> referring to the bridge chips throughout the tree as "LS7A" helped.
>>>>
>>>> In any case, for the sake of consistency, you can definitely refer
>>>> to the CPU models in natural language like "LS3Axxxx"; just make
>>>> sure to refactor for example every occurrence in arch/loongarch and
>>>> other parts of drivers/. That's a lot of churn, though, so I don't
>>>> expect such changes to get accepted, and that's why the tree-wide
>>>> consistency should be favored over the local one.
>>>>
>>> There are document[1] which named LS7A1000 bridge chip as Loongson
>>> 7A1000 Bridge,
>>>
>>> which is opposed to what you have said "the existing convention is
>>> LS7Xxxxx for bridges".
>>>
>>>
>>> there are also plenty projects[2] which encode ls2k1000 as project
>>> name, which simply
>>>
>>> don't fall into the category as you have mentioned("Loongson 3Axxxx").
>>>
>>>
>>> See [1][2] for reference, how to explain this phenomenon then?
>>
>> Turn down the flames a little bit, okay? ;-)
>>
>>
> There is no flames, its just that it need sufficient discussion when
> started to contribute to community.
>
> We want more rigorous toward to our patch.
>
>
> We can't adopt irresponsible ideas, especially from someone who is
> reluctant to give a
>
> reasonable rationale and refused to discussion.
>
>
> Such changes could probably made a damage to Loongson company.
>
> As it tend to introduce self-contradictory between the code and comment.
>
> Especially when we introduce DT support, there is no write space in
> the middle the string is allowed.
>
'write' -> 'white'
> and encode model information to the compatible string is an common
> practice.
>
>
> While at it, I will take it into another consideration if there are
> more professional person who
>
> is supporting your ideas and could take the responsibility for it.
>
> Beside this, other reviews are still acceptable, thanks for the
> reasonable part.
>
>
next prev parent reply other threads:[~2023-05-25 4:16 UTC|newest]
Thread overview: 43+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-05-20 10:57 [PATCH v14 0/2] " Sui Jingfeng
2023-05-20 10:57 ` [PATCH v14 1/2] " Sui Jingfeng
2023-05-21 12:21 ` WANG Xuerui
2023-05-22 7:27 ` Sui Jingfeng
2023-05-22 8:02 ` Sui Jingfeng
2023-05-22 8:09 ` WANG Xuerui
2023-05-22 8:29 ` Sui Jingfeng
2023-05-22 8:42 ` WANG Xuerui
2023-05-24 2:56 ` Huacai Chen
2023-06-12 14:40 ` Sui Jingfeng
2023-05-22 8:14 ` Sui Jingfeng
2023-05-22 8:19 ` WANG Xuerui
2023-05-22 8:51 ` Sui Jingfeng
2023-05-22 9:05 ` WANG Xuerui
2023-05-22 9:05 ` Sui Jingfeng
2023-05-22 9:09 ` WANG Xuerui
2023-05-22 9:25 ` Sui Jingfeng
2023-05-22 9:28 ` WANG Xuerui
2023-05-22 9:49 ` Sui Jingfeng
2023-05-22 10:05 ` WANG Xuerui
2023-05-22 10:17 ` Sui Jingfeng
2023-05-22 10:25 ` WANG Xuerui
2023-05-22 13:13 ` Sui Jingfeng
2023-05-22 16:40 ` WANG Xuerui
2023-05-24 2:52 ` Huacai Chen
2023-05-25 4:09 ` Sui Jingfeng
2023-05-25 4:14 ` Sui Jingfeng [this message]
2023-05-22 11:11 ` Sui Jingfeng
2023-05-22 9:39 ` Sui Jingfeng
2023-06-13 16:20 ` Sui Jingfeng
2023-06-13 17:29 ` Sui Jingfeng
2023-05-20 10:57 ` [PATCH v14 2/2] MAINTAINERS: add maintainers for DRM LOONGSON driver Sui Jingfeng
2023-06-12 14:58 ` [PATCH v14 0/2] drm: add kms driver for loongson display controller Sui Jingfeng
2023-06-13 8:30 ` Maxime Ripard
2023-06-13 8:35 ` Sui Jingfeng
2023-06-13 9:10 ` Maxime Ripard
2023-06-13 9:17 ` Sui Jingfeng
2023-06-13 9:28 ` Maxime Ripard
2023-06-13 9:32 ` Sui Jingfeng
2023-06-13 9:41 ` Sui Jingfeng
2023-06-13 8:40 ` Sui Jingfeng
2023-06-13 9:11 ` Maxime Ripard
-- strict thread matches above, loose matches on Subject: below --
2023-05-20 10:54 Sui Jingfeng
2023-05-20 10:54 ` [PATCH v14 1/2] " Sui Jingfeng
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=5f70f46b-8c53-c55b-761a-6bb50c01b2b1@189.cn \
--to=15330273260@189.cn \
--cc=airlied@gmail.com \
--cc=christian.koenig@amd.com \
--cc=daniel@ffwll.ch \
--cc=dri-devel@lists.freedesktop.org \
--cc=emil.l.velikov@gmail.com \
--cc=geert+renesas@glider.be \
--cc=javierm@redhat.com \
--cc=kernel@xen0n.name \
--cc=linaro-mm-sig@lists.linaro.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-media@vger.kernel.org \
--cc=liupeibao@loongson.cn \
--cc=liyi@loongson.cn \
--cc=loongson-kernel@lists.loongnix.cn \
--cc=maarten.lankhorst@linux.intel.com \
--cc=mripard@kernel.org \
--cc=nathan@kernel.org \
--cc=sumit.semwal@linaro.org \
--cc=tzimmermann@suse.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®