<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On Apr 23, 2019, at 5:06 PM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" class="">jonas@devlieghere.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><br class=""></div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Apr 23, 2019 at 5:00 PM Tanya Lattner <<a href="mailto:tanyalattner@llvm.org" class="">tanyalattner@llvm.org</a>> wrote:<br class=""></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space" class=""><br class=""><div class=""><br class=""><blockquote type="cite" class=""><div class="">On Apr 23, 2019, at 11:54 AM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>> wrote:</div><br class="gmail-m_6763502056381782657Apple-interchange-newline"><div class=""><div class=""><div dir="auto" class="">Hey Tanya,</div></div><div class=""><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Apr 23, 2019 at 11:51 Tanya Lattner <<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a>> wrote:<br class=""></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space" class="">Jonas,<div class=""><br class=""></div><div class="">Ignore what I said before as these do need to be separate targets. It appears the new targets are running doxygen. This isn’t something we typically do as a post commit hook since it takes awhile. I’ll need to do this via the doxygen nightly script. Any concerns?</div></div><div style="word-wrap:break-word;line-break:after-white-space" class=""><div class=""></div></div></blockquote><div dir="auto" class=""> </div><div dir="auto" class="">That sounds perfect. Can we still do the regular website post commit? </div></div></div></div></blockquote><div class=""><br class=""></div>Yes, so it will do <span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class="">docs-</span><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures;color:rgb(255,255,255);background-color:rgb(0,0,0)" class="">lldb</span><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class="">-html on every commit.</span></div></div></blockquote><div class=""><br class=""></div><div class="">Perfect! </div><div class=""> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space" class=""><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class=""><br class=""></span></div><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class="">So I am able to generate the cpp reference docs: <a href="https://lldb.llvm.org/cpp_reference/index.html" target="_blank" class="">https://lldb.llvm.org/cpp_reference/index.html</a></span></div><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class=""><br class=""></span></div><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class="">However, the main website links to <a href="https://lldb.llvm.org/cpp_reference/html/index.html" target="_blank" class="">https://lldb.llvm.org/cpp_reference/html/index.html</a>. Do you want the html in that url? I can change the alias. We strip for other doxygen.</span></div></div></blockquote><div class=""><br class=""></div><div class="">Let's keep it without the html. I'll update a link on the website and add a redirect. </div><div class=""> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space" class=""><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class=""><br class=""></span></div><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class="">As for python docs, what is required to build those? It's not showing up as a target for me.</span></div></div></blockquote><div class=""><br class=""></div><div class="">This is probably because you don't have `epydoc` installed (sudo pip install epydoc). </div><div class="">I think you'll have to re-run cmake after for it to pick it up. The corresponding target should then be `lldb-python-doc`. <br class=""></div><div class=""><br class=""></div><div class=""><a href="https://lldb.llvm.org/cpp_reference/index.html" class="">https://lldb.llvm.org/cpp_reference/index.html</a></div></div></div></div></div></div></div></blockquote><div><br class=""></div>Well installing epydoc did the trick, but I don’t think the doxygen script is the right place for this target. I have not dug into it yet but it appears to require some LLVM libraries and is building those. I’m letting it finish to verify it builds but I’ll have to sort out the best way of doing this on the server. We have other scripts that generate other documentation that build parts of LLVM. Ideally, I would want to leverage that and reduce build times.</div><div><br class=""></div><div>-Tanya<br class=""><blockquote type="cite" class=""><div class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div class="gmail_quote"><div class=""> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space" class=""><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class=""><br class=""></span></div><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class="">Thanks,</span></div><div class=""><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures" class="">Tanya</span></div></div></blockquote><div class=""><br class=""></div><div class="">Thanks again for doing this.</div><div class=""><br class=""></div><div class="">Cheers,</div><div class="">Jonas</div><div class=""> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space" class=""><div class=""><br class=""></div><div class=""><font face="Menlo" class=""><span style="font-size:11px" class=""><br class=""></span></font></div><div class=""><blockquote type="cite" class=""><div class=""><div class=""><div class="gmail_quote"><div dir="auto" class=""><br class=""></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space" class=""><div class=""><br class=""></div><div class="">-Tanya</div></div></blockquote><div dir="auto" class=""><br class=""></div><div dir="auto" class="">Thank you! </div><div dir="auto" class=""><br class=""></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space" class=""><div class=""></div><div class=""><div class=""><br class=""><blockquote type="cite" class=""><div class="">On Apr 23, 2019, at 11:45 AM, Tanya Lattner <<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a>> wrote:</div><br class="gmail-m_6763502056381782657m_-1273615495498671391Apple-interchange-newline"><div class=""><div style="word-wrap:break-word;line-break:after-white-space" class="">Anytime new targets are added, the script has to be modified. Is there a way you can put them all under a top level html target? Or is there a reason not to?<div class=""><br class=""></div><div class="">-Tanya<br class=""><div class=""><div class=""><br class=""><blockquote type="cite" class=""><div class="">On Apr 19, 2019, at 12:17 PM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>> wrote:</div><br class="gmail-m_6763502056381782657m_-1273615495498671391Apple-interchange-newline"><div class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class="">Hey Tanya,<div class=""><br class=""></div><div class="">Thanks again for migrating the LLDB website so it is generated with Sphinx!</div><div class=""><br class=""></div><div class="">I made a change yesterday that hasn't been propagated yet. It looks like it might have something to do with <a href="http://lists.llvm.org/pipermail/www-scripts/2019-April/007524.html" target="_blank" class="">http://lists.llvm.org/pipermail/www-scripts/2019-April/007524.html</a>. </div><div class=""><br class=""></div><div class="">Also, as the result of this change the following two links are broken:</div><div class=""><br class=""></div><div class=""><a href="https://lldb.llvm.org/cpp_reference/" target="_blank" class="">https://lldb.llvm.org/cpp_reference/</a><br class=""></div><div class=""><a href="https://lldb.llvm.org/python_reference/" target="_blank" class="">https://lldb.llvm.org/python_reference/</a><br class=""></div><div class=""><br class=""></div><div class="">Could we make the script generate those two folders as well? The corresponding CMake target are lldb-cpp-doc and lldb-python-doc.</div><div class=""><br class=""></div><div class="">Thank you,Or</div><div class="">Jonas</div><div class=""><br class=""></div><div class="">PS: I've included lldb-dev in CC so everyone knows we're working on the missing documentation. </div></div></div></div></div></div></div>
</div></blockquote></div><br class=""></div></div></div></div></blockquote></div><br class=""></div></div></blockquote></div></div>-- <br class=""><div dir="ltr" class="gmail-m_6763502056381782657gmail_signature">Sent from my iPhone</div>
</div></blockquote></div><br class=""></div></blockquote></div></div></div></div></div>
</div></blockquote></div><br class=""></body></html>