<div class="gmail_quote">On Mon, Jun 18, 2012 at 6:25 AM, Mikael Lyngvig <span dir="ltr"><<a href="mailto:mikael@lyngvig.org" target="_blank">mikael@lyngvig.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi all,<div><br></div><div>Here's an updated version of my proposed "Building with MinGW on Windows" document. In summary, the document gives a step-by-step description of how to build LLVM + Clang on Windows WITHOUT having Microsoft Visual Studio installed. The high-level goal of the document is to make life pleasant for those wonderful Windows users who desire to try out LLVM and/or Clang. I believe the document makes it a piece of cake to get up and running with LLVM + Clang on Windows, and that's exactly what I was hoping for.</div>
<div><br></div><div>Changes are many:</div><div><br></div><div> 1. The document has been made more slim and now contains less chattering.</div><div> 2. The document now uses Ninja instead of MinGW Makefiles. This solves a bunch of problems and also speeds up the build process substantially because of the broken "make -j" behavior seen with some or all GNU Makes on Windows.</div>
<div> 3. The document now covers 32-bit and 64-bit builds with MinGW tools (if anybody know of an alternate BINARY distribution of MinGW64 than Drangon's release, please let me know so I can include it in the document).</div>
<div> 4. The document now does NOT mention anything about unit tests or test suites, etc. These things will be explained in another document, be it through patches to existing documents or through an entirely new document.</div>
<div> 5. The document is now much smaller because it only introduces what I deem to be the essential tools: CMake, Ninja, MinGWnn, Python, and Subversion.</div><div> 6. The document now has significantly few chapters and sections in it, making the overall experience much less confusing and overwhelming for the newbie LLVM and/or Clang user.</div>
<div> 7. The document no longer mentions my name because I personally prefer a documentation strategy where there is no author mentioned in the documents. If this is an unacceptable omission, just let me know, and I'll add my name again.</div>
<div><br></div><div>To view the document as it will look on the website, make sure you have Sphinx installed and then copy the attached file to llvm/docs, and run "make html", after which you'll find the document in llvm\docs\_build\html\Building...html. </div>
<div><br></div><div>The document has NOT been linked into the LLVM documentation tree because it seems that there is still some uncertainty as to whether this document is useful or not.</div><div><br></div><div>Any and all comments are greatly appreciated. I do think, however, that it is time that we settle on this being an atomic document that cannot be split up further.</div>
</blockquote><div><br></div><div>Generally, I think this looks very good! A few nit-picks:</div><div><ol><li>You should probably list the somewhat-more-popular mingw64 distributions available from:
<a href="http://mingw-w64.sourceforge.net/">http://mingw-w64.sourceforge.net/</a></li><li>You may want to mention TortoiseSVN as an alternative to SlikSVN, as that seems to be a popular choice</li><li>As much as I like Ninja, I would add a section on mingw32-make as that is the only "official" build choice at the moment ("official" meaning supported by CMake developers)</li>
</ol><div>Thanks for working on this!</div></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div><br></div><div><br></div><div>Regards,</div><div>Mikael<br clear="all"><div>-- Disclaimer: I am <b>not</b> arrogant in real life, so if you perceive me as being arrogant, you are to blame ;-)</div><div><br></div>
</div>
<br>_______________________________________________<br>
cfe-dev mailing list<br>
<a href="mailto:cfe-dev@cs.uiuc.edu">cfe-dev@cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><br><div>Thanks,</div><div><br></div><div>Justin Holewinski</div><br>