<div dir="ltr">Awesome. I'm happy with moving the .rst file into that directory and not have it on the public website. I'll try to make a patch that lands enough scaffolding to build `not` in the next few days, and then I'll land the other build files I have through the regular build process after that. Unless someone feels strongly, I'll go with Justin's suggestion of llvm/utils/gn/...</div><br><div class="gmail_quote"><div dir="ltr">On Tue, Nov 6, 2018 at 12:20 PM David Blaikie <<a href="mailto:dblaikie@gmail.com">dblaikie@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Yeah, I don't feel super strongly about the name or location if it's a single directory entry point. Not sure if/where it should be documented (if it needs web documentation - rather than or in addition to a README in that directory) - don't really want to muddy the waters in the official docs as others have mentioned. I'm OK with it going in-tree under those conditions, FWIW.</div><br><div class="gmail_quote"><div dir="ltr">On Tue, Nov 6, 2018 at 3:10 AM Nico Weber via cfe-dev <<a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">The value in having them somewhere in-tree is that it's easier for people collaborate on these files, and it's way lower setup overhead if someone wants to try it out. If people prefer llvm/util over llvm/experimental, that's fine with me.<div><br></div><div>There would only be a single directory that will contain build files for all of llvm, clang, lld, etc. The build files would be in llvm/whatever/gn/tree/{llvm,clang,lld,...}/... ("tree" can be any name). That's not the most natural way to use gn, but I agree that having BUILD.gn files scattered all over the tree could make it look like gn is supported at some level.</div><div><br></div><div>If adding the files in an isolated directory still ends up being confusing in practice, we can move them out at that point. But I'd like to start with the simpler way and see if that's good enough.</div></div><br><div class="gmail_quote"><div dir="ltr">On Mon, Nov 5, 2018 at 8:22 PM Justin Bogner <<a href="mailto:mail@justinbogner.com" target="_blank">mail@justinbogner.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Nico Weber via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a>> writes:<br>
> If I read this correctly, there isn't much opposition to landing the gn<br>
> files as long as it's very clear that regular devs aren't supposed to<br>
> update them and that it's clear that they're experimental<br>
><br>
> The main concerns I've heard so far:<br>
><br>
> - Having two build systems is confusing. I can see this, but I think<br>
> putting the gn files below llvm/experimental/gn (instead of right into the<br>
> source, like I currently have) and updating GN.rst to explicitly say<br>
> "Reviewers should not ask patch authors to update gn files in addition to<br>
> the cmake files" will address this.<br>
<br>
I haven't been following this discussion and I don't really know<br>
anything about GN, but I'm not very convinced by this.<br>
<br>
I'm opposed to adding a second build system in general. We all remember<br>
having two build systems before and it's a pain keep track of as well as<br>
a documentation nightmare in telling people yet more ways to do<br>
things. Our docs are already confusing enough given that we currently<br>
support two completely different layouts of source directories for<br>
cmake.<br>
<br>
I suppose putting it somewhere under utils/ as a kind of tool for people<br>
who want to use it like we do with text editor support and such things<br>
wouldn't be the end of the world, but the value of that is pretty<br>
limited if you're explicitly opting them out of community maintenance.<br>
<br>
If the build files can be maintained in their own directory, and will<br>
only be updated by some set of people who are using them, why not track<br>
them in a separate source repo? This way when a breaking change happens<br>
your build system could still be made to work for the commits in between<br>
the time that happens and the GN files are updated, since you'd be<br>
maintaining a separate mapping of which versions work together.<br>
<br>
> - Having a few people care about the GN build means these people won't<br>
> improve the cmake build. I think this has some merit (but I did clean up<br>
> parts of the cmake build a bit while reading all our cmake code to create<br>
> the gn build for example, and I have several ideas about improving the<br>
> cmake build I want to implement at some point; and it's also not a given<br>
> that the folks who may or may not end up working on the GN build would have<br>
> worked on the cmake build). However, this is true independently of where<br>
> the GN build files are stored.<br>
><br>
> - GN isn't a cmake replacement, for distro reasons and whatnot. I<br>
> wholeheartedly agree with this. Maybe GN will become better here, but cmake<br>
> is ubiquitous _today_, and it's backed by a company who's interested in<br>
> keeping it around, so it will be around for a long time. I think this is<br>
> cmake's biggest strength. That's why I'm not proposing on replacing the<br>
> cmake build. If the GN build at some point is way better (compiler-rt,<br>
> lldb, etc added; out-of-tree build support; GN itself gets a real distro<br>
> story; ...) then this _may_ be different in a few years, at which point we<br>
> could reconsider. I think this is unlikely to happen.<br>
><br>
> (I still don't see that any of these problems are being solved by having<br>
> this in an overlay or a separate fork.)<br>
><br>
> And again, It's a real possibility that we check this in and it turns out<br>
> the people who are interested in don't feel it's all that useful, it<br>
> bitrots, and we delete it again. That's cool, no harm done. I think we<br>
> should have a very high standard for replacing the supported build system<br>
> (cmake), but I think it's cool to have a low bar for people experimenting<br>
> with unsupported build systems, as long as they get deleted if not used. If<br>
> someone wanted to a, say, llvm/experimental/meson to see how that would<br>
> feel, I think that'd be super cool too for example.<br>
><br>
> On Fri, Nov 2, 2018 at 2:06 AM Dean Michael Berris <<a href="mailto:dean.berris@gmail.com" target="_blank">dean.berris@gmail.com</a>><br>
> wrote:<br>
><br>
>> I think this is how, after moving to a monorepo, it may be feasible to<br>
>> get this in a separate fork.<br>
>><br>
>> Granted the Git Monorepo + GitHub happens, we can even make it so that<br>
>> the GN build is a branch on the official git repository, which can<br>
>> track the mainline development.<br>
>> On Fri, Nov 2, 2018 at 3:49 AM David Blaikie via llvm-dev<br>
>> <<a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a>> wrote:<br>
>> ><br>
>> > Any easy way to do this as some kind of overlay, so they GN files<br>
>> wouldn't live in the LLVM repository, but in a separate one?<br>
>> ><br>
>> > (this might avoid some of the community discussion - though would<br>
>> perhaps still likely have the issue I see as most significant: With a<br>
>> sufficient number of developers using GN, the rate of build breaks due to<br>
>> those developers missing CMake file updates might rise to be a bit of a<br>
>> drag on the LLVM project - though I don't think that's likely to ever be a<br>
>> huge deal, just an annoyance)<br>
>> ><br>
>> > On Wed, Oct 31, 2018 at 11:19 AM Nico Weber via cfe-dev <<br>
>> <a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a>> wrote:<br>
>> >><br>
>> >> Hi,<br>
>> >><br>
>> >> first things first: If you're happy with cmake, you can stop reading<br>
>> now. Nobody is proposing that LLVM moves off cmake, and nobody is proposing<br>
>> anything that's causing people using cmake more work.<br>
>> >><br>
>> >> At the LLVM conference, I gave a lightning talk [1] about using GN [2]<br>
>> to build LLVM and clang. cmake is great for many use cases, but in my<br>
>> opinion local day-to-day development isn't one of them. So I wrote GN build<br>
>> files for LLVM and clang, enough to make `ninja check-llvm check-clang<br>
>> check-lld` build everything needed for these three test suites and that all<br>
>> tests pass. This works on Linux, Mac, Win hosts targeting X86, ARM,<br>
>> AArch64. You can see them at [3].<br>
>> >><br>
>> >> I had been worried that it would be a lot of work to keep the build<br>
>> files up to date, but I've been using this for all my LLVM/clang/lld<br>
>> development the last 8 months, and it turned out to not be a big problem --<br>
>> LLVM's build files don't change very often, and GN build files are a<br>
>> pleasure to work with in my opinion.<br>
>> >><br>
>> >> I gave the lightning talk just to talk about my personal workflow, but<br>
>> there was a lot of interest. We had a roundtable on the next day, and about<br>
>> 20 people said they'd be interested in using this for their development<br>
>> too. The main request was that the .gn files are checked in upstream, so<br>
>> that we can collaborate on keeping them working. Two to three orgs even<br>
>> said they'd be interested in moving their buildbots to GN.<br>
>> >><br>
>> >> As mentioned at the top, the intention here is not to replace cmake,<br>
>> only to offer an opt-in alternative for people who are interested in it.<br>
>> Keeping the GN build going would be the responsibility of people using it,<br>
>> not of the general LLVM community. If this fails to find use and bitrots,<br>
>> we can easily remove it again.<br>
>> >><br>
>> >> Are there any concerns with checking in GN files? I've put some initial<br>
>> docs for the GN build at <a href="https://reviews.llvm.org/D53944" rel="noreferrer" target="_blank">https://reviews.llvm.org/D53944</a> ; it describes<br>
>> what the GN build is and is not, what its advantages are (speed and easier<br>
>> configurability), and some points about the philosophy behind the LLVM GN<br>
>> build.<br>
>> >><br>
>> >> If folks are generally ok with GN files living in-tree, I'll start<br>
>> sending patches for gradually adding gn files through the regular review<br>
>> process.<br>
>> >><br>
>> >> If having a BUILD.gn file in every directory being confusing is a<br>
>> concern, GN has the concept of a "secondary tree" so that all GN files<br>
>> could be below llvm/gn/tree/{llvm,clang,lld,...}.<br>
>> >><br>
>> >> Cheers,<br>
>> >> Nico<br>
>> >><br>
>> >> 1: <a href="https://llvm.org/devmtg/2018-10/talk-abstracts.html#lt2" rel="noreferrer" target="_blank">https://llvm.org/devmtg/2018-10/talk-abstracts.html#lt2</a><br>
>> >> 2: <a href="https://gn.googlesource.com/gn" rel="noreferrer" target="_blank">https://gn.googlesource.com/gn</a> , <a href="https://is.gd/gn_intro" rel="noreferrer" target="_blank">https://is.gd/gn_intro</a><br>
>> >> 3:<br>
>> <a href="https://github.com/llvm-project/llvm-project-20170507/compare/master...nico:gn" rel="noreferrer" target="_blank">https://github.com/llvm-project/llvm-project-20170507/compare/master...nico:gn</a><br>
>> , click "Files Changed" to see the GN files.<br>
>> >> _______________________________________________<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="http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev</a><br>
>> ><br>
>> > _______________________________________________<br>
>> > LLVM Developers mailing list<br>
>> > <a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a><br>
>> > <a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
>><br>
>><br>
>><br>
>> --<br>
>> Dean<br>
>><br>
> _______________________________________________<br>
> LLVM Developers mailing list<br>
> <a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a><br>
> <a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
</blockquote></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="http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev</a><br>
</blockquote></div>
</blockquote></div>