<div dir="ltr">Sorry for the insanely late reply.<div><br></div><div>This all looks great. Thanks for all the hard work!<div><br></div><div>-- Sean Silva</div></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">
On Tue, Mar 18, 2014 at 8:46 AM, Renato Golin <span dir="ltr"><<a href="mailto:renato.golin@linaro.org" target="_blank">renato.golin@linaro.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi folks,<br>
<br>
It took a while, but I finally have some bandwidth to look at this.<br>
<br>
I've been reading the two existing TableGen documents:<br>
<br>
<a href="http://llvm.org/docs/TableGenFundamentals.html" target="_blank">http://llvm.org/docs/TableGenFundamentals.html</a><br>
<a href="http://llvm.org/docs/TableGen/LangRef.html" target="_blank">http://llvm.org/docs/TableGen/LangRef.html</a><br>
<br>
the first is linked from the index, but LangRef is not (though it has<br>
some remains in the metadata). I'm wondering what's the relationship<br>
between them two.<br>
<br>
My plan is to have three docs:<br>
<br>
1. What is TableGen; No info about language, back-ends but just a<br>
rough idea on when it's used (build-time), why it's used (meta-code),<br>
where (a list of back-ends with a simple description) and which<br>
additional cases could be covered by the current implementation.<br>
<br>
2. TableGen back-ends; a list of all back-ends in use today, what are<br>
their purposes, why they differ and some inner secrets of their<br>
implementation. This page could also have a tutorial on how to create<br>
a new back-end, though this could be in a separate doc.<br>
<br>
3. TableGen's language reference; Similar to most of fundamentals' and<br>
LangRef's contents, only focusing on syntax.<br>
<br>
Aditional pages:<br>
<br>
* Deficiencies and plans to overcome them<br>
* How to create a new back-end<br>
<br>
All pages should be inside the TableGen directory with its own index.<br>
<br>
I'll create the docs but won't link them from the main index, so that<br>
if I get it completely wrong, people won't get the wrong idea. Once<br>
it's better than the original, we can switch and continue.<br>
<br>
Does that sound like a good plan?<br>
<br>
cheers,<br>
--renato<br>
</blockquote></div><br></div>