<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
I think documenting recent M and A cores would be an excellent start. An exhaustive list, also each core combination, is not very doable I think simply because of the many combinations. At least, not when generating the doc is a manual job. But even if we could
 auto-generate the exhaustive list, I don't know yet how useful that is if we only expect an handful of implementations per core. Too much info maybe? A curated list could be better? Again, I think the M55 is a good example. Saying this from memory I thought
 there were 20+ architecture combinations, but we expect these 5 to be possibly implemented...</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
Looking forward to the option work. So I am guessing at this point this doc work could coexist with that, and in the mean time it can help users and also us when we add new cores.</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
Cheers.<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div id="appendonsend"></div>
<hr style="display:inline-block;width:98%" tabindex="-1">
<div id="divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" style="font-size:11pt" color="#000000"><b>From:</b> David Spickett <david.spickett@linaro.org><br>
<b>Sent:</b> 21 April 2020 17:34<br>
<b>To:</b> Sjoerd Meijer <Sjoerd.Meijer@arm.com><br>
<b>Cc:</b> David Blaikie <dblaikie@gmail.com>; cfe-dev@lists.llvm.org Developers <cfe-dev@lists.llvm.org>; Peter Smith <Peter.Smith@arm.com>; Kristof Beyls <Kristof.Beyls@arm.com><br>
<b>Subject:</b> Re: [cfe-dev] ARM CPU CLI options and examples (was: Option -mtune)</font>
<div> </div>
</div>
<div>
<div dir="ltr">
<div>Is the intention to have an exhaustive list, or target common use cases?</div>
<div><br>
</div>
I intend to restart work on (<a href="http://lists.llvm.org/pipermail/llvm-dev/2018-September/126346.html">http://lists.llvm.org/pipermail/llvm-dev/2018-September/126346.html</a>) which proposed teaching Clang more about the options so it could list and validate
 them itself. So there's scope to eventually generate a page that has all the combinations.
<div>(it's a long way off of being done though so don't take this as reason to stop documentation efforts, in fact examples would be useful for me too)</div>
</div>
<br>
<div class="x_gmail_quote">
<div dir="ltr" class="x_gmail_attr">On Tue, 21 Apr 2020 at 17:12, Sjoerd Meijer via cfe-dev <<a href="mailto:cfe-dev@lists.llvm.org">cfe-dev@lists.llvm.org</a>> wrote:<br>
</div>
<blockquote class="x_gmail_quote" style="margin:0px 0px 0px 0.8ex; border-left:1px solid rgb(204,204,204); padding-left:1ex">
<div dir="ltr">
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
Following up on the -mtune discussion yesterday, I have prepared a draft patch (<a href="https://reviews.llvm.org/D78565" id="x_gmail-m_-8153955636080125394LPlnk398319" target="_blank">https://reviews.llvm.org/D78565</a>) that shows how to target different
 ARM CPU implementations and architecture combinations, for now only 2 M-profile cores.</div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<br>
</div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
In the -mtune thread, I mentioned that setting options is non-trivial and I think the Cortex-M55 as documented with examples in D78565 is a good example of that. I.e., it only shows 5 architecture combinations and their corresponding CLI options. Many more
 architecture combinations are possible, but these 5 combinations are the most likely to be implemented. In the V8-A architecture space, the challenge of many architecture combinations is similar.</div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<br>
</div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
My thinking was that it would be valuable to have a listing of architecture combinations and options, so that users can quickly look up an architecture configuration and find its flags to target it. These examples shows usage of this tool (i.e. open-source
 clang), add puts documentation/examples in the same place as the source, and allows easier edit/reviews and also from non-Arm people. On D78565, Peter raised the question whether
<span>this is suited for the Clang Documentation, or if we should move this to some place at
<a href="http://arm.com" target="_blank">arm.com</a>. <br>
</span></div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<span><br>
</span></div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<span>So my question is if there are any ideas/preferences/objections for this?</span></div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<span><br>
</span></div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<span>Cheers.<br>
</span></div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<span></span><br>
</div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<br>
</div>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)">
<br>
</div>
<font size="3" face="Times New Roman"><span style="font-size:12pt">
<div><font size="2"><span style="font-size:11pt"></span></font></div>
</span></font>
<div dir="ltr">
<div>
<div dir="ltr">
<div>
<blockquote style="margin:0px 0px 0px 0.8ex; border-left:1px solid rgb(204,204,204); padding-left:1ex">
<div dir="ltr"></div>
</blockquote>
</div>
</div>
</div>
</div>
</div>
_______________________________________________<br>
cfe-dev mailing list<br>
<a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a><br>
<a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev" rel="noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev</a><br>
</blockquote>
</div>
</div>
</body>
</html>