<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Apr 23, 2019 at 6:04 PM Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com">jonas@devlieghere.com</a>> wrote:<br></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 dir="ltr"><div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Apr 23, 2019 at 5:43 PM Tanya Lattner <<a href="mailto:tanyalattner@llvm.org" target="_blank">tanyalattner@llvm.org</a>> wrote:<br></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"><br><div><br><blockquote type="cite"><div>On Apr 23, 2019, at 5:06 PM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank">jonas@devlieghere.com</a>> wrote:</div><br class="gmail-m_3382499287039632410gmail-m_-2876956853059931062Apple-interchange-newline"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><br></div><br><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" target="_blank">tanyalattner@llvm.org</a>> wrote:<br></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"><br><div><br><blockquote type="cite"><div>On Apr 23, 2019, at 11:54 AM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank">jonas@devlieghere.com</a>> wrote:</div><br class="gmail-m_3382499287039632410gmail-m_-2876956853059931062gmail-m_6763502056381782657Apple-interchange-newline"><div><div><div dir="auto">Hey Tanya,</div></div><div><br><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">tanyalattner@llvm.org</a>> wrote:<br></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">Jonas,<div><br></div><div>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"><div></div></div></blockquote><div dir="auto">  </div><div dir="auto">That sounds perfect. Can we still do the regular website post commit? </div></div></div></div></blockquote><div><br></div>Yes, so it will do <span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures">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)">lldb</span><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures">-html on every commit.</span></div></div></blockquote><div><br></div><div>Perfect! </div><div> </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"><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures"><br></span></div><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures">So I am able to generate the cpp reference docs: <a href="https://lldb.llvm.org/cpp_reference/index.html" target="_blank">https://lldb.llvm.org/cpp_reference/index.html</a></span></div><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures"><br></span></div><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures">However, the main website links to <a href="https://lldb.llvm.org/cpp_reference/html/index.html" target="_blank">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><br></div><div>Let's keep it without the html. I'll update a link on the website and add a redirect. </div><div> </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"><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures"><br></span></div><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures">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><br></div><div>This is probably because you don't have `epydoc` installed (sudo pip install epydoc). </div><div>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></div><div><br></div><div><a href="https://lldb.llvm.org/cpp_reference/index.html" target="_blank">https://lldb.llvm.org/cpp_reference/index.html</a></div></div></div></div></div></div></div></blockquote><div><br></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></blockquote><div><br></div><div>Yeah, the annoying thing about the Python documentation is that it builds the C++ API, then runs swig to generate the Python wrapper, and finally generates the docs from that. </div><div>I wonder if we can just use the static bindings that are checked-in instead. I will look into that later today/tomorrow. </div></div></div></div></blockquote><div><br></div><div>Right, so the reason is that we don't have the static bindings on <a href="http://llvm.org">llvm.org</a> (we have them for swift-lldb on GitHub). </div><div>Maybe we should check them in upstream too? That's something the community will have to weigh in on... </div><div> </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 dir="ltr"><div dir="ltr"><div class="gmail_quote"><div> <br></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"><div><br></div><div>-Tanya<br><blockquote type="cite"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div class="gmail_quote"><div> </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"><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures"><br></span></div><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures">Thanks,</span></div><div><span style="font-family:Menlo;font-size:11px;font-variant-ligatures:no-common-ligatures">Tanya</span></div></div></blockquote><div><br></div><div>Thanks again for doing this.</div><div><br></div><div>Cheers,</div><div>Jonas</div><div> </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"><div><br></div><div><font face="Menlo"><span style="font-size:11px"><br></span></font></div><div><blockquote type="cite"><div><div><div class="gmail_quote"><div dir="auto"><br></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"><div><br></div><div>-Tanya</div></div></blockquote><div dir="auto"><br></div><div dir="auto">Thank you! </div><div dir="auto"><br></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"><div></div><div><div><br><blockquote type="cite"><div>On Apr 23, 2019, at 11:45 AM, Tanya Lattner <<a href="mailto:tanyalattner@llvm.org" target="_blank">tanyalattner@llvm.org</a>> wrote:</div><br class="gmail-m_3382499287039632410gmail-m_-2876956853059931062gmail-m_6763502056381782657m_-1273615495498671391Apple-interchange-newline"><div><div style="word-wrap:break-word;line-break:after-white-space">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><br></div><div>-Tanya<br><div><div><br><blockquote type="cite"><div>On Apr 19, 2019, at 12:17 PM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank">jonas@devlieghere.com</a>> wrote:</div><br class="gmail-m_3382499287039632410gmail-m_-2876956853059931062gmail-m_6763502056381782657m_-1273615495498671391Apple-interchange-newline"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr">Hey Tanya,<div><br></div><div>Thanks again for migrating the LLDB website so it is generated with Sphinx!</div><div><br></div><div>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">http://lists.llvm.org/pipermail/www-scripts/2019-April/007524.html</a>. </div><div><br></div><div>Also, as the result of this change the following two links are broken:</div><div><br></div><div><a href="https://lldb.llvm.org/cpp_reference/" target="_blank">https://lldb.llvm.org/cpp_reference/</a><br></div><div><a href="https://lldb.llvm.org/python_reference/" target="_blank">https://lldb.llvm.org/python_reference/</a><br></div><div><br></div><div>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><br></div><div>Thank you,Or</div><div>Jonas</div><div><br></div><div>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></div></div></div></div></blockquote></div><br></div></div></blockquote></div></div>-- <br><div dir="ltr" class="gmail-m_3382499287039632410gmail-m_-2876956853059931062gmail-m_6763502056381782657gmail_signature">Sent from my iPhone</div>
</div></blockquote></div><br></div></blockquote></div></div></div></div></div>
</div></blockquote></div><br></div></blockquote></div></div></div>
</blockquote></div></div>