<div dir="ltr">Hello again, LLVM Developers.<div><br></div><div>I just wanted to check in one more time and see if there were any other potential technical authors in the group.  In this chain, we've seen some reasons why there should not be an introductory LLVM book as well as a good reason why there should be.  I'm still hoping that we can find a primary author that can write a technical manuscript that makes it easier for newcomer developer to join the project, as technical documentation, no matter how well written and formatted, can still be overwhelming.</div><div><br></div><div>Please let me know and I'll pass it on to the editors at Packt.</div><div><br></div><div>Thanks,</div><div>Matthew Emerick</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, Aug 15, 2020 at 8:38 PM Min-Yih Hsu <<a href="mailto:minyihh@uci.edu">minyihh@uci.edu</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div style="overflow-wrap: break-word;"><br><div>Hi Matthew,</div><div><br><blockquote type="cite"><div>On Aug 15, 2020, at 4:13 PM, Matthew Emerick <<a href="mailto:crosstrainedmind@gmail.com" target="_blank">crosstrainedmind@gmail.com</a>> wrote:</div><br><div><div dir="auto">Hello, Min.<div dir="auto"><br></div><div dir="auto">I suppose I should ask you this: what do people need to know before working with LLVM? </div></div></div></blockquote><div>First will of course be the basic compiler knowledge from traditional text books. Then for LLVM specifically (not including Clang and other sub-projects), if there is one thing I wish to know when I first started my LLVM career, it would be a project directory map telling me which folder (and even which file) to dig in if I want to work on feature X. Because as you probably know, lots of LLVM documentations are sitting in code comments, and just like I mentioned in previous email, some of them changed pretty frequently, but the overall folder structures rarely changed (Nevertheless, I think one of the LLVM document web pages has a similar ‘project map', but it’s a little bit too high level IMO).</div><div><br></div><div>Another thing might be a structural learning map, organizing knowledges by areas in compiler. First divided by logic groups like frontend, target-independent optimizations, code generations. Then for each of them, goes into specific topics like RA, vectorizations, semantic checking etc.</div><div><br></div><div>Other more trivial things that might be useful for beginners include stuff in the Programmers Manual Page (<a href="http://llvm.org/docs/ProgrammersManual.html" target="_blank">http://llvm.org/docs/ProgrammersManual.html</a>). That is, what utilities (these rarely change either) are available, and when to use.</div><br><blockquote type="cite"><div><div dir="auto"><div dir="auto">Could a book work with that and link it to LLVM specifically? </div></div></div></blockquote><div>I’m not sure and have no particular comments about the links</div><div><br></div><div>These are just based on my personal experiences, hope they help :-)</div><div><br></div><div>Best,</div><div>-Min</div><br><blockquote type="cite"><div><div dir="auto"><div dir="auto"><br></div><div dir="auto">Thanks,</div><div dir="auto">Matthew</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, Aug 15, 2020, 7:06 PM Min-Yih Hsu via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi Matthew and all,<br>
<br>
Also I feel like one of the obstacles would be the fast-changing APIs. Since to my understanding this book is not a compiler textbook full with theory stuffs, as a ‘Getting Started' book for practitioners it’s hard to avoid API usages and best practices, which are both pretty unstable IMO (yes, even for best practices, for example the recommended way to use DominatorTree has changed over time).<br>
<br>
It might be a good idea to have some books for beginners, since the knowledge barrier of this project is still relatively higher than other open source projects. But I think you might also want to provide some ideas on how to put this book in an unique position in terms of its contribution on easing up the learning curve. Otherwise I agree with what Pavel said, the official document website is good enough: It can be updated whenever we want and articles were usually written by LLVM veterans. <br>
<br>
Best,<br>
-Min<br>
> On Aug 15, 2020, at 1:55 AM, Pavel Kosov via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org" rel="noreferrer" target="_blank">llvm-dev@lists.llvm.org</a>> wrote:<br>
> <br>
> Hi, Matthew, all<br>
> nice to hear about interest from Packt Publishing for LLVM<br>
> I think there are a lot of professionals in this mailing list, who can be an author of the book.<br>
> But writing a good book demands a lot of time, so that's why there are not so many responses (and also maybe because of well-formed and updated online documentation, which can be a good replacement for the book).<br>
> Nevertheless, I think that one comprehensive well-written book can be really useful for helping newcomers be involved in LLVM more quickly, so I would offer my help to the person, who will be able to take the responsibility to be an author (I can write some chapters, e.g. about PGO, internal structures like DAG, etc)<br>
> <br>
> Pavel<br>
> <br>
> -----------------------------<br>
> <br>
> Hello, LLVM Developers.<br>
> <br>
> My name is Matthew Emerick and I have an opportunity for you and the LLVM<br>
> project.  I represent Packt Publishing in the acquisition of new material<br>
> to publish.  I have been working with one of their Product Managers, who<br>
> may have reached out to you, and he asked for my help in securing an author<br>
> for a book about LLVM.<br>
> <br>
> >From my discussions with the Product Manager, Packt is looking for a book<br>
> about an overview of the project along with best practices from a user<br>
> perspective.  Off the top of my head, I could see an introductory chapter<br>
> with the history of the project and a high level overview.  Then a section<br>
> about the technologies involved and what they do.  Then finish up with a<br>
> chapter of best practices through some example projects.<br>
> <br>
> Is there any interest on your end? Will you consider it?  I look forward to<br>
> your response.<br>
> <br>
> Thanks,<br>
> Matthew Emerick  <br>
> _______________________________________________<br>
> LLVM Developers mailing list<br>
> <a href="mailto:llvm-dev@lists.llvm.org" rel="noreferrer" target="_blank">llvm-dev@lists.llvm.org</a><br>
> <a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
<br>
_______________________________________________<br>
LLVM Developers mailing list<br>
<a href="mailto:llvm-dev@lists.llvm.org" rel="noreferrer" target="_blank">llvm-dev@lists.llvm.org</a><br>
<a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
</blockquote></div>
</div></blockquote></div><br></div></blockquote></div>