llvm dev - Jul 2020 - Combine TableGen documents?

I've spent the last few days reading and rereading the TableGen documents. I
thought I would try to improve the "Language Introduction" and the
"Language Reference." But now I think it makes sense to combine the
two documents. It isn't really possible for someone to use TableGen without
reading both of them. Also, the factoring is unusual in some places. For
example, the complete list of value expression facilities is in the Introduction
rather than the Reference.

What do people think of this idea?

One reason not to do it is that it might be a waste of energy: Most of the uses
of TableGen may already be in place.

----------------------------------------------------------------
Windfall               Paul C. Anagnostopoulos 
      ----------------------------------------------------------
   Software            978 369-0839
                             www.windfall.com
----------------------------------------------------------------
My life has been filled with calamities,
some of which actually happened.
---Mark Twain 

Guga 'mzimba, sala 'nhliziyo

+David Greene <dag at cray.com> as someone who might have an opinion.

I don't have a strong opinion, but if someone wants to try to make the docs
better and more friendly to them I'm totally down :)

-eric

On Wed, Jul 29, 2020 at 7:24 AM Paul C. Anagnostopoulos via llvm-dev <
llvm-dev at lists.llvm.org> wrote:
> I've spent the last few days reading and rereading the TableGen
documents.
> I thought I would try to improve the "Language Introduction" and
the
> "Language Reference." But now I think it makes sense to combine
the two
> documents. It isn't really possible for someone to use TableGen without
> reading both of them. Also, the factoring is unusual in some places. For
> example, the complete list of value expression facilities is in the
> Introduction rather than the Reference.
>
> What do people think of this idea?
>
> One reason not to do it is that it might be a waste of energy: Most of the
> uses of TableGen may already be in place.
>
> ----------------------------------------------------------------
> Windfall               Paul C. Anagnostopoulos
>       ----------------------------------------------------------
>    Software            978 369-0839
>                              www.windfall.com
> ----------------------------------------------------------------
> My life has been filled with calamities,
> some of which actually happened.
> ---Mark Twain
>
> Guga 'mzimba, sala 'nhliziyo
>
> _______________________________________________
> LLVM Developers mailing list
> llvm-dev at lists.llvm.org
> https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20200729/fd4bf870/attachment.html>