Re: [Xen-devel] [PATCH for-4.13 v2 2/2] docs: Replace all instance of ARM by Arm

From: Julien Grall <julien.grall@arm.com>
To: Volodymyr Babchuk <Volodymyr_Babchuk@epam.com>
Cc: "jgross@suse.com" <jgross@suse.com>,
	Stefano Stabellini <sstabellini@kernel.org>, Wei Liu <wl@xen.org>,
	Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>,
	George Dunlap <George.Dunlap@eu.citrix.com>,
	Andrew Cooper <andrew.cooper3@citrix.com>,
	Ian Jackson <ian.jackson@eu.citrix.com>, Tim Deegan <tim@xen.org>,
	Jan Beulich <jbeulich@suse.com>,
	"xen-devel@lists.xenproject.org" <xen-devel@lists.xenproject.org>
Subject: Re: [Xen-devel] [PATCH for-4.13 v2 2/2] docs: Replace all instance of ARM by Arm
Date: Tue, 24 Sep 2019 16:28:37 +0100	[thread overview]
Message-ID: <ca85e985-e40e-e701-6fc4-efc541f2f00f@arm.com> (raw)
In-Reply-To: <877e5xagjs.fsf@epam.com>

Hi,

On 9/24/19 3:56 PM, Volodymyr Babchuk wrote:
> Julien Grall writes:
> 
>> The documentation is using a mix of ARM (old) and Arm (new). To stay
>> consistent, use only the new name.
>>
> Honestly, this rename confuses me. I think, this commit is the good
> place to clarify a couple of questions.

It did confuse a lot when the rename was made by Arm... What I want to 
avoid is mixing the both in the documentation as this makes things more 
difficult to follow.

There are probably more to tidy up, but then you have to start somewhere.

> 
> 1. How to write company name correctly? Looks like it is "Arm", despite
> "arm" logo.

When using in a sentence, the preferred version is "Arm" to avoid 
confusion with the word "arm".

For more information regarding the writing see: 
https://www.arm.com/company/policies/trademarks

For, the rest of the e-mail is more blur and this is based on my own 
opinion.

> 
> 2. Correct name for architecture families is Arm, right?

The Arm architecture

> E.g. "Arm
> processor" or "Arm system".

I am not sure which answer you are looking for here. For the former, you 
are speaking about a given processor (e.g. Cortex-A15) whilst the latter 
is a set of multiples processors + devices (i.e. SoC).

> 
> 3. What about certain architecture? Arm site uses "Armv8-A", not
> "Arm v8".

If you want to be pedantic, we should use Armv8-A. But it is widely 
accepted in the to use Armv8. The version "Arm v8" is not very common 
and should probably replaced.

> 
> 4. AFAIK, arm32 and arm64 are not existing officially, so should you
> rename them?

This is an abuse from Linux but commonly used. In Xen, we are abusing 
further and use Arm64 to refer to Armv8 system and Arm32 to refer to 
Armv7 system.

> 
> 5. What about "AArch64"/"AArch32"? Is this correct?

AArch64 and AArch32 is the correct naming per the spec.

> 
> Slightly related question: Xen or XEN?

I tend to use Xen. I don't know if there are any recommendation here.

Cheers,

-- 
Julien Grall

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel