<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 14 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.hoenzb
{mso-style-name:hoenzb;}
span.EmailStyle18
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri","sans-serif";}
@page WordSection1
{size:8.5in 11.0in;
margin:56.7pt 42.5pt 56.7pt 85.05pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Hello,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">I am new to this alias but still wanted to pitch in. When I was learning tablegen syntax I found tablegen tests to be a lot more educative than examples in
the “tablegen fundamentals”.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">I’d hope that newer documentation found adopt some of those tests as examples. I found writing backends quite easy but modifying front end rather hard. I wanted
to modify the parser to allow #NAME# notation in multiclasses to be used in the right side of definitions but could not find an easy way to inject such change.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Thanks,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Ivan<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> llvmdev-bounces@cs.uiuc.edu [mailto:llvmdev-bounces@cs.uiuc.edu]
<b>On Behalf Of </b>Sean Silva<br>
<b>Sent:</b> 05 June, 2012 7:49<br>
<b>To:</b> reed kotler<br>
<b>Cc:</b> llvmdev@cs.uiuc.edu<br>
<b>Subject:</b> Re: [LLVMdev] technical debt<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">FWIW, I'm putting together (hopefully to be done by the end of this weekend) a substantial refactoring of the TableGen backend API along with shiny new documentation (reStructuredText with sphinx) of all of TableGen, including documentation
about how to write backends and---depending on how adventurous I get---a more detailed coverage of the syntax.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Also, Reed, in your TableGen talk, IIRC, you guessed that there are maybe ~10KLOC of TableGen, and said something to the tune that it wasn't too late to move over to something new and better. There are over 100KLOC in TableGen files, so
unfortunately a "flag day" transition to another language is out of the question.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Feel free to get in contact with me if you would like to discuss TableGen or related topics.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">--Sean Silva<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">On Mon, Jun 4, 2012 at 5:42 PM, reed kotler <<a href="mailto:rkotler@mips.com" target="_blank">rkotler@mips.com</a>> wrote:<o:p></o:p></p>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">On 06/04/2012 05:17 PM, Daniel Berlin wrote:<br>
> Can we get back to the substantive discussion about your ideas for<br>
> lessening the technical debt?<o:p></o:p></p>
</div>
<p class="MsoNormal">The lessening requires enlisting people that are willing to do this as<br>
opposed to doing fun science like cool optimization. I,for example, find<br>
the documentaiton, cleanup and refactoring to be interesting so I don't<br>
feel cheated to work on it as opposed to implementing some new fangled<br>
register allocator.<br>
<br>
For example, there is almost no documentation on all the application<br>
specific plugins for tablegen.<br>
There are some tablegen files and some small comments here and there and<br>
you can guess<br>
some of it from just knowing about compilers but it's nothing close to<br>
what could be called<br>
documentation.<br>
<br>
I've started on my own to try and further document tablegen. I gave a<br>
talk/tutorial at LLVM<br>
Europe on the general tablegen language and it was well received. Even<br>
people that had worked<br>
with it for a while said they took away things they never understood<br>
about it.<br>
<br>
It was clear when I studied tablegen that there are many serious<br>
problems with it from a language<br>
point of view and from a tool point view. Those things would all need to<br>
be cleared up before<br>
some bigger form of it that could go beyond just laying out data<br>
structures could be<br>
developed.<br>
<br>
If there is sufficient interest, I think that maybe a separate<br>
discussion list to deal with technical<br>
debt would make sense. I think for a lot of people it would be<br>
uninteresting to get all those<br>
extra posts.<br>
<br>
It's a question of enlisting people that want to work on it and<br>
convincing people that are not interested to work on it that it's<br>
something important to do and to welcome the help and<br>
not obstruct the effort.<br>
<br>
So far I have created some google code projects for various things I'm<br>
interested to work on.<br>
I've created separate google code projects because I don't have the<br>
bandwidth to work on this<br>
if there is resistance to it. So in my google code areas, I can do what<br>
I want without a big<br>
discussion on every step. So maybe only my team will use it and then it<br>
can just sit in google code<br>
forever.<br>
<br>
So there is a cutting edge of the llvm/clang project which will never<br>
want to wait for all the technical debt to get paid. This is a natural<br>
thing. You can't more forward trying to make everything be A+ quality;<br>
you can only do the A+ work after some reflection and experience with a<br>
given problem and rewriting and refactoring it many times. But at the<br>
same time, the technical debt needs to be settled or it will get out of<br>
hand and unpayable in the future.<br>
<span style="color:#888888"><br>
<span class="hoenzb">Reed</span></span><o:p></o:p></p>
<div>
<div>
<p class="MsoNormal"><br>
> On Mon, Jun 4, 2012 at 8:05 PM, reed kotler<<a href="mailto:rkotler@mips.com">rkotler@mips.com</a>> wrote:<br>
>> Well, differences of opinion is what makes horse races.<br>
>><br>
>> Reed<br>
>><br>
>><br>
>> On 06/04/2012 04:57 PM, Daniel Berlin wrote:<br>
>>> On Mon, Jun 4, 2012 at 7:53 PM, reed kotler<<a href="mailto:rkotler@mips.com">rkotler@mips.com</a>> wrote:<br>
>>>> On 06/04/2012 03:25 PM, Daniel Berlin wrote:<br>
>>>>> I'm pretty sure neither llvm nor clang have any technical debt at all.<br>
>>>>><br>
>>>>> On Mon, Jun 4, 2012 at 5:18 PM, reed kotler<<a href="mailto:rkotler@mips.com">rkotler@mips.com</a>> wrote:<br>
>>>>>> something to think about as llvm and clang grows.<br>
>>>>>><br>
>>>>>> <a href="http://en.wikipedia.org/wiki/Technical_debt" target="_blank">http://en.wikipedia.org/wiki/Technical_debt</a><br>
>>>>>> _______________________________________________<br>
>>>>>> LLVM Developers mailing list<br>
>>>>>> <a href="mailto:LLVMdev@cs.uiuc.edu">LLVMdev@cs.uiuc.edu</a> <a href="http://llvm.cs.uiuc.edu" target="_blank">
http://llvm.cs.uiuc.edu</a><br>
>>>>>> <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev" target="_blank">
http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev</a><br>
>>>> I hope you are joking.<br>
>>>><br>
>>> Why would I be joking?<br>
>>><br>
>>>> It's not meant as a criticism of llvm or clang but there is already an<br>
>>>> enormous amount<br>
>>>> of technical debt.<br>
>>> I don't see that.<br>
>>><br>
>>>> It's something to try and get a handle on before it gets out of hand.<br>
>>> The consequences will never be the same<br>
>>>> Documentation is one area where it is accumulating fast but there are<br>
>>>> others.<br>
>>> I think LLVM is incredibly well documented<br>
>>>> Testing is another area.<br>
>>> It also has at least 10-15 tests.<br>
>>>> Tablegen alone has huge technical debt.<br>
>>> I'm sorry you feel that way.<br>
>>>> To me, there should be a cap placed on the number of lines of code in<br>
>>>> llvm.<br>
>>> Will there be a credit offset system?<br>
>>>> Like a budget. We should try and rewrite and refactor to keep the number<br>
>>>> of<br>
>>>> lines from growing<br>
>>>> without bound.<br>
>>>><br>
>>>> At this point lots of patterns should be developing where other tools<br>
>>>> (like<br>
>>>> tablegen) could be<br>
>>>> written to reduce the amount of code and make things more understandable.<br>
>>> I agree. We should macroize most of the passes so they aren't so wordy.<br>
>>><br>
>>>> Reed<br>
>>>><br>
<br>
_______________________________________________<br>
LLVM Developers mailing list<br>
<a href="mailto:LLVMdev@cs.uiuc.edu">LLVMdev@cs.uiuc.edu</a> <a href="http://llvm.cs.uiuc.edu" target="_blank">
http://llvm.cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev</a><o:p></o:p></p>
</div>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
<br>
<hr>
<font face="Arial" color="Gray" size="1">This e-mail and any attachment(s) are intended only for the recipient(s) named above and others who have been specifically authorized to receive them. They may contain confidential information. If you are not the intended
recipient, please do not read this email or its attachment(s). Furthermore, you are hereby notified that any dissemination, distribution or copying of this e-mail and any attachment(s) is strictly prohibited. If you have received this e-mail in error, please
immediately notify the sender by replying to this e-mail and then delete this e-mail and any attachment(s) or copies thereof from your system. Thank you.<br>
</font>
</body>
</html>