<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 May 7, 2019, at 4:48 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="">Thanks Tanya! I can see the website was updated. I've added a timestamp to the Sphinx configuration, but it doesn't show up on the website. I'm not sure whether that's because I did something wrong or because the site is still not generated post-commit. <div class=""><br class=""></div></div></div></div></blockquote><div><br class=""></div><div>You are right. I needed to change one more thing to trigger the script. Can you try to change one thing now? </div><br class=""><blockquote type="cite" class=""><div class=""><div dir="ltr" class=""><div dir="ltr" class=""><div class="">Did you change anything to where the Doxygen is generated? I updated all the links to remove the /html/ form the URL and put a redirect in place, but now the cpp docs are back at their old location: <a href="https://lldb.llvm.org/cpp_reference/html/index.html" class="">https://lldb.llvm.org/cpp_reference/html/index.html</a></div></div></div></div></blockquote><div><br class=""></div><div>Yes! I forgot we had this conversation. Sorry about that. I just changed it back.</div><div><br class=""></div><div>-Tanya</div><div><br class=""></div><div><br class=""></div><br class=""><blockquote type="cite" class=""><div class=""><div dir="ltr" class=""><div dir="ltr" class=""><div class=""><br class=""></div><div class="">Thank,</div><div class="">Jonas</div></div></div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, May 7, 2019 at 4:08 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="">Ok, I believe everything should be working. So the cpp ref and python ref are generated nightly. Sphinx/web is done post-commit. I just ran it by hand and you can see the script output: <a href="http://lists.llvm.org/pipermail/www-scripts/2019-May/007606.html" target="_blank" class="">http://lists.llvm.org/pipermail/www-scripts/2019-May/007606.html</a><div class=""><br class=""></div><div class="">Is it possible for you to add a timestamp to the bottom of the sphinx generated webpages? That would also make it easy to spot if it hasn’t run recently. <br class=""><div class=""><br class=""></div><div class="">If you aren’t seeing something updated, please let me know. If you add new targets, I have to do that manually as it's not automatic.</div><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Tanya</div><div class=""><br class=""><div class=""><br class=""><blockquote type="cite" class=""><div class="">On May 7, 2019, at 9:28 AM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>> wrote:</div><br class="gmail-m_-3010719048958158579Apple-interchange-newline"><div class=""><div dir="ltr" class="">Hey Tanya,<div class=""><br class=""></div><div class="">That's great. I see the Python documentation is online now! </div><div class=""><br class=""></div><div class="">Unfortunately it appears that the Sphinx part still isn't updating. I pushed a bunch of changes last week and none have made it to the homepage yet. I checked the www-scripts mailing list but I don't see any failures for LLDB. Do you know what's up here?</div><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Jonas</div></div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, May 7, 2019 at 12:19 AM 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="">Ignore this. svn wasn’t actually updating the src tree. It works! I just need doxygen script to finish and it will be confirmed tonight.<div class=""><br class=""></div><div class=""><div class=""><br class=""></div><div class="">-Tanya<br class=""><div class=""><br class=""><blockquote type="cite" class=""><div class="">On May 6, 2019, at 11:55 PM, Tanya Lattner <<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a>> wrote:</div><br class="gmail-m_-3010719048958158579gmail-m_750030438209475145Apple-interchange-newline"><div class=""><div style="word-wrap:break-word;line-break:after-white-space" class="">I’m not sure it is working. To clarify, nothing in LLVM should be compiled to build the python docs correct? <div class=""><br class=""></div><div class="">So I shouldn’t see this?</div><div class=""><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(200,20,201)" class=""><span style="font-variant-ligatures:no-common-ligatures" class=""><b class="">Scanning dependencies of target liblldb_exports</b></span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(64,11,217)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class=""><b class="">Creating export file for liblldb</b></span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] Built target liblldb_exports</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(200,20,201)" class=""><span style="font-variant-ligatures:no-common-ligatures" class=""><b class="">Scanning dependencies of target LLVMDemangle</b></span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Demangle/CMakeFiles/LLVMDemangle.dir/Demangle.cpp.o</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Demangle/CMakeFiles/LLVMDemangle.dir/ItaniumDemangle.cpp.o</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Demangle/CMakeFiles/LLVMDemangle.dir/MicrosoftDemangle.cpp.o</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Demangle/CMakeFiles/LLVMDemangle.dir/MicrosoftDemangleNodes.cpp.o</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class=""><b class="">Linking CXX static library ../libLLVMDemangle.a</b></span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] Built target LLVMDemangle</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(200,20,201)" class=""><span style="font-variant-ligatures:no-common-ligatures" class=""><b class="">Scanning dependencies of target LLVMSupport</b></span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Support/CMakeFiles/LLVMSupport.dir/AArch64TargetParser.cpp.o</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Support/CMakeFiles/LLVMSupport.dir/ARMTargetParser.cpp.o</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Support/CMakeFiles/LLVMSupport.dir/AMDGPUMetadata.cpp.o</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Support/CMakeFiles/LLVMSupport.dir/APFloat.cpp.o</span></div><div style="margin:0px;font-stretch:normal;font-size:11px;line-height:normal;font-family:Menlo;color:rgb(47,180,29)" class=""><span style="font-variant-ligatures:no-common-ligatures" class="">[ 0%] </span><span style="font-variant-ligatures:no-common-ligatures" class="">Building CXX object lib/Support/CMakeFiles/LLVMSupport.dir/APInt.cpp.o</span></div><div class=""><span style="font-variant-ligatures:no-common-ligatures" class=""><br class=""></span></div><div class="">Do I need any additional config options?</div><div class=""><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Tanya<br class=""><div class=""><br class=""><blockquote type="cite" class=""><div class="">On May 3, 2019, at 8:58 AM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>> wrote:</div><br class="gmail-m_-3010719048958158579gmail-m_750030438209475145Apple-interchange-newline"><div class=""><div dir="ltr" class="">Hey Tanya,<div class=""><br class=""></div><div class="">It appears the website is still stuck. It hasn't picked up my changes from earlier this week. Please let me know if there's anything I can do to help.</div><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Jonas</div></div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, May 1, 2019 at 10:40 PM 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="">I will give this a shot. I did remove the changes before to prevent any issue.<div class=""><br class=""></div><div class="">-Tanya<br class=""><div class=""><div class=""><br class=""><blockquote type="cite" class=""><div class="">On Apr 29, 2019, at 10:26 AM, Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>> wrote:</div><br class="gmail-m_-3010719048958158579gmail-m_750030438209475145gmail-m_-7140745995012254208Apple-interchange-newline"><div class=""><div dir="ltr" class="">I've merged the aforementioned patch. <div class=""><br class=""></div><div class="">Tanya, can you give generating the python docs another shot?</div><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Jonas</div></div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Apr 26, 2019 at 4:29 PM Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</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 dir="ltr" class=""><div dir="ltr" class="">I've put up a patch to make it possible to generate the python reference without building lldb at all: <a href="https://reviews.llvm.org/D61216" target="_blank" class="">https://reviews.llvm.org/D61216</a></div><div dir="ltr" class=""><br class=""></div><div class="">PS: The website isn't updating anymore, is that because of the python reference generation?</div></div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Apr 24, 2019 at 11:46 AM Ted Woodward <<a href="mailto:tedwood@quicinc.com" target="_blank" class="">tedwood@quicinc.com</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">That's the issue - lldb-python-doc depends on liblldb. From docs/CMakeLists.txt:<br class="">
<br class="">
if(EPYDOC_EXECUTABLE)<br class="">
find_program(DOT_EXECUTABLE dot)<br class="">
if(DOT_EXECUTABLE)<br class="">
set(EPYDOC_OPTIONS ${EPYDOC_OPTIONS} --graph all --dotpath ${DOT_EXECUTABLE})<br class="">
endif()<br class="">
set(DOC_DIR "${CMAKE_CURRENT_SOURCE_DIR}/doc")<br class="">
file(MAKE_DIRECTORY "${DOC_DIR}")<br class="">
#set(ENV{PYTHONPATH} ${CMAKE_CURRENT_BINARY_DIR}/../../../lib/python2.7/site-packages)<br class="">
add_custom_target(lldb-python-doc<br class="">
${EPYDOC_EXECUTABLE}<br class="">
--html<br class="">
lldb<br class="">
-o ${CMAKE_CURRENT_BINARY_DIR}/python_reference<br class="">
--name "LLDB python API"<br class="">
--url "<a href="http://lldb.llvm.org/" rel="noreferrer" target="_blank" class="">http://lldb.llvm.org</a>"<br class="">
${EPYDOC_OPTIONS}<br class="">
DEPENDS swig_wrapper liblldb<br class="">
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/../../../lib${LLVM_LIBDIR_SUFFIX}/python2.7/site-packages<br class="">
COMMENT "Generating LLDB Python API reference with epydoc" VERBATIM<br class="">
)<br class="">
endif(EPYDOC_EXECUTABLE)<br class="">
<br class="">
<br class="">
> -----Original Message-----<br class="">
> From: lldb-dev <<a href="mailto:lldb-dev-bounces@lists.llvm.org" target="_blank" class="">lldb-dev-bounces@lists.llvm.org</a>> On Behalf Of Pavel Labath<br class="">
> via lldb-dev<br class="">
> Sent: Wednesday, April 24, 2019 1:16 AM<br class="">
> To: Jonas Devlieghere <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>>; Tanya Lattner<br class="">
> <<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a>><br class="">
> Cc: LLDB <<a href="mailto:lldb-dev@lists.llvm.org" target="_blank" class="">lldb-dev@lists.llvm.org</a>><br class="">
> Subject: [EXT] Re: [lldb-dev] LLDB Website<br class="">
> <br class="">
> On 24/04/2019 03:19, Jonas Devlieghere via lldb-dev wrote:<br class="">
> ><br class="">
> ><br class="">
> > On Tue, Apr 23, 2019 at 6:04 PM Jonas Devlieghere<br class="">
> > <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a> <mailto:<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>>> wrote:<br class="">
> ><br class="">
> ><br class="">
> ><br class="">
> > On Tue, Apr 23, 2019 at 5:43 PM Tanya Lattner <<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a><br class="">
> > <mailto:<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a>>> wrote:<br class="">
> ><br class="">
> ><br class="">
> ><br class="">
> >> On Apr 23, 2019, at 5:06 PM, Jonas Devlieghere<br class="">
> >> <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a> <mailto:<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>>> wrote:<br class="">
> >><br class="">
> >><br class="">
> >><br class="">
> >> On Tue, Apr 23, 2019 at 5:00 PM Tanya Lattner<br class="">
> >> <<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a> <mailto:<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a>>> wrote:<br class="">
> >><br class="">
> >><br class="">
> >><br class="">
> >>> On Apr 23, 2019, at 11:54 AM, Jonas Devlieghere<br class="">
> >>> <<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a> <mailto:<a href="mailto:jonas@devlieghere.com" target="_blank" class="">jonas@devlieghere.com</a>>><br class="">
> wrote:<br class="">
> >>><br class="">
> >>> Hey Tanya,<br class="">
> >>><br class="">
> >>> On Tue, Apr 23, 2019 at 11:51 Tanya Lattner<br class="">
> >>> <<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a> <mailto:<a href="mailto:tanyalattner@llvm.org" target="_blank" class="">tanyalattner@llvm.org</a>>> wrote:<br class="">
> >>><br class="">
> >>> Jonas,<br class="">
> >>><br class="">
> >>> Ignore what I said before as these do need to be<br class="">
> >>> separate targets. It appears the new targets are<br class="">
> >>> running doxygen. This isn’t something we typically do<br class="">
> >>> as a post commit hook since it takes awhile. I’ll<br class="">
> >>> need to do this via the doxygen nightly script. Any<br class="">
> >>> concerns?<br class="">
> >>><br class="">
> >>> That sounds perfect. Can we still do the regular website<br class="">
> >>> post commit?<br class="">
> >><br class="">
> >> Yes, so it will do docs-lldb-html on every commit.<br class="">
> >><br class="">
> >><br class="">
> >> Perfect!<br class="">
> >><br class="">
> >><br class="">
> >> So I am able to generate the cpp reference docs:<br class="">
> >> <a href="https://lldb.llvm.org/cpp_reference/index.html" rel="noreferrer" target="_blank" class="">https://lldb.llvm.org/cpp_reference/index.html</a><br class="">
> >><br class="">
> >> However, the main website links to<br class="">
> >> <a href="https://lldb.llvm.org/cpp_reference/html/index.html" rel="noreferrer" target="_blank" class="">https://lldb.llvm.org/cpp_reference/html/index.html</a>. Do<br class="">
> >> you want the html in that url? I can change the alias. We<br class="">
> >> strip for other doxygen.<br class="">
> >><br class="">
> >><br class="">
> >> Let's keep it without the html. I'll update a link on the<br class="">
> >> website and add a redirect.<br class="">
> >><br class="">
> >><br class="">
> >> As for python docs, what is required to build those? It's<br class="">
> >> not showing up as a target for me.<br class="">
> >><br class="">
> >><br class="">
> >> This is probably because you don't have `epydoc` installed<br class="">
> >> (sudo pip install epydoc).<br class="">
> >> I think you'll have to re-run cmake after for it to pick it<br class="">
> >> up. The corresponding target should then be `lldb-python-doc`.<br class="">
> >><br class="">
> >> <a href="https://lldb.llvm.org/cpp_reference/index.html" rel="noreferrer" target="_blank" class="">https://lldb.llvm.org/cpp_reference/index.html</a><br class="">
> ><br class="">
> > Well installing epydoc did the trick, but I don’t think the<br class="">
> > doxygen script is the right place for this target. I have not<br class="">
> > dug into it yet but it appears to require some LLVM libraries<br class="">
> > and is building those. I’m letting it finish to verify it builds<br class="">
> > but I’ll have to sort out the best way of doing this on the<br class="">
> > server. We have other scripts that generate other documentation<br class="">
> > that build parts of LLVM. Ideally, I would want to leverage that<br class="">
> > and reduce build times.<br class="">
> ><br class="">
> ><br class="">
> > Yeah, the annoying thing about the Python documentation is that it<br class="">
> > builds the C++ API, then runs swig to generate the Python wrapper,<br class="">
> > and finally generates the docs from that.<br class="">
> <br class="">
> It should be possible to solve this by tweaking the dependency graph a bit.<br class="">
> There's no fundamental reason why you need to build anything in order to<br class="">
> run swig. It is purely a textual step -- it ingests header files and interface<br class="">
> definitions and spits out python and cpp files. The inputs are present as static<br class="">
> checked in source, so the swig step could theoretically be the very first build<br class="">
> command that we run.<br class="">
> <br class="">
> > I wonder if we can just use the static bindings that are checked-in<br class="">
> > instead. I will look into that later today/tomorrow.<br class="">
> ><br class="">
> ><br class="">
> > Right, so the reason is that we don't have the static bindings on<br class="">
> > <a href="http://llvm.org/" rel="noreferrer" target="_blank" class="">llvm.org</a> <<a href="http://llvm.org/" rel="noreferrer" target="_blank" class="">http://llvm.org</a>> (we have them for swift-lldb on GitHub).<br class="">
> > Maybe we should check them in upstream too? That's something the<br class="">
> > community will have to weigh in on...<br class="">
> ><br class="">
> <br class="">
> I think it would be good to avoid that...<br class="">
> <br class="">
> pl<br class="">
> _______________________________________________<br class="">
> lldb-dev mailing list<br class="">
> <a href="mailto:lldb-dev@lists.llvm.org" target="_blank" class="">lldb-dev@lists.llvm.org</a><br class="">
> <a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-dev" rel="noreferrer" target="_blank" class="">https://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-dev</a><br class="">
</blockquote></div>
</blockquote></div>
</div></blockquote></div><br class=""></div></div></div></blockquote></div>
</div></blockquote></div><br class=""></div></div></div></div></div></blockquote></div><br class=""></div></div></div></blockquote></div>
</div></blockquote></div><br class=""></div></div></div></blockquote></div>
</div></blockquote></div><br class=""></body></html>