Re: [lldb-dev] LLDB Website

2019-05-06 Thread Jonas Devlieghere via lldb-dev 
Friendly ping.

On Fri, May 3, 2019 at 8:58 AM Jonas Devlieghere 
wrote:

> Hey Tanya,
>
> 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.
>
> Thanks,
> Jonas
>
> On Wed, May 1, 2019 at 10:40 PM Tanya Lattner 
> wrote:
>
>> I will give this a shot. I did remove the changes before to prevent any
>> issue.
>>
>> -Tanya
>>
>> On Apr 29, 2019, at 10:26 AM, Jonas Devlieghere 
>> wrote:
>>
>> I've merged the aforementioned patch.
>>
>> Tanya, can you give generating the python docs another shot?
>>
>> Thanks,
>> Jonas
>>
>> On Fri, Apr 26, 2019 at 4:29 PM Jonas Devlieghere 
>> wrote:
>>
>>> I've put up a patch to make it possible to generate the python reference
>>> without building lldb at all: https://reviews.llvm.org/D61216
>>>
>>> PS: The website isn't updating anymore, is that because of the python
>>> reference generation?
>>>
>>> On Wed, Apr 24, 2019 at 11:46 AM Ted Woodward 
>>> wrote:
>>>
 That's the issue - lldb-python-doc depends on liblldb. From
 docs/CMakeLists.txt:

 if(EPYDOC_EXECUTABLE)
   find_program(DOT_EXECUTABLE dot)
 if(DOT_EXECUTABLE)
   set(EPYDOC_OPTIONS ${EPYDOC_OPTIONS} --graph all --dotpath
 ${DOT_EXECUTABLE})
 endif()
 set(DOC_DIR "${CMAKE_CURRENT_SOURCE_DIR}/doc")
 file(MAKE_DIRECTORY "${DOC_DIR}")
 #set(ENV{PYTHONPATH}
 ${CMAKE_CURRENT_BINARY_DIR}/../../../lib/python2.7/site-packages)
 add_custom_target(lldb-python-doc
   ${EPYDOC_EXECUTABLE}
   --html
   lldb
   -o ${CMAKE_CURRENT_BINARY_DIR}/python_reference
   --name "LLDB python API"
   --url "http://lldb.llvm.org";
   ${EPYDOC_OPTIONS}
   DEPENDS swig_wrapper liblldb
   WORKING_DIRECTORY
 ${CMAKE_CURRENT_BINARY_DIR}/../../../lib${LLVM_LIBDIR_SUFFIX}/python2.7/site-packages
   COMMENT "Generating LLDB Python API reference with epydoc"
 VERBATIM
 )
 endif(EPYDOC_EXECUTABLE)


 > -Original Message-
 > From: lldb-dev  On Behalf Of Pavel
 Labath
 > via lldb-dev
 > Sent: Wednesday, April 24, 2019 1:16 AM
 > To: Jonas Devlieghere ; Tanya Lattner
 > 
 > Cc: LLDB 
 > Subject: [EXT] Re: [lldb-dev] LLDB Website
 >
 > On 24/04/2019 03:19, Jonas Devlieghere via lldb-dev wrote:
 > >
 > >
 > > On Tue, Apr 23, 2019 at 6:04 PM Jonas Devlieghere
 > > mailto:jo...@devlieghere.com>> wrote:
 > >
 > >
 > >
 > > On Tue, Apr 23, 2019 at 5:43 PM Tanya Lattner <
 tanyalatt...@llvm.org
 > > > wrote:
 > >
 > >
 > >
 > >> On Apr 23, 2019, at 5:06 PM, Jonas Devlieghere
 > >> mailto:jo...@devlieghere.com>>
 wrote:
 > >>
 > >>
 > >>
 > >> On Tue, Apr 23, 2019 at 5:00 PM Tanya Lattner
 > >> mailto:tanyalatt...@llvm.org>>
 wrote:
 > >>
 > >>
 > >>
 > >>> On Apr 23, 2019, at 11:54 AM, Jonas Devlieghere
 > >>> mailto:jo...@devlieghere.com
 >>
 > wrote:
 > >>>
 > >>> Hey Tanya,
 > >>>
 > >>> On Tue, Apr 23, 2019 at 11:51 Tanya Lattner
 > >>> mailto:tanyalatt...@llvm.org>>
 wrote:
 > >>>
 > >>> Jonas,
 > >>>
 > >>> 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?
 > >>>
 > >>> That sounds perfect. Can we still do the regular
 website
 > >>> post commit?
 > >>
 > >> Yes, so it will do docs-lldb-html on every commit.
 > >>
 > >>
 > >> Perfect!
 > >>
 > >>
 > >> So I am able to generate the cpp reference docs:
 > >> https://lldb.llvm.org/cpp_reference/index.html
 > >>
 > >> However, the main website links to
 > >> https://lldb.llvm.org/cpp_reference/html/index.html.
 Do
 > >> you want the html in that url? I can change the alias.
 We
 > >> strip for other doxygen.
 > >>
 > >>
 > >> Let's keep it without the html. I'll update a link on the
 > >> website and add a redirect.
 > >>
 > >>
 > >> As for python docs, what is required to build those?
 It's
 > >> not showing up as a target for me.
 > >>
 > >>
 > >> This is probably because you don't have `epydoc` installed
 > >>

Re: [lldb-dev] LLDB Website

2019-05-06 Thread Tanya Lattner via lldb-dev 
I’m not sure it is working. To clarify, nothing in LLVM should be compiled to 
build the python docs correct? 

So I shouldn’t see this?
Scanning dependencies of target liblldb_exports
[  0%] Creating export file for liblldb
[  0%] Built target liblldb_exports
Scanning dependencies of target LLVMDemangle
[  0%] Building CXX object 
lib/Demangle/CMakeFiles/LLVMDemangle.dir/Demangle.cpp.o
[  0%] Building CXX object 
lib/Demangle/CMakeFiles/LLVMDemangle.dir/ItaniumDemangle.cpp.o
[  0%] Building CXX object 
lib/Demangle/CMakeFiles/LLVMDemangle.dir/MicrosoftDemangle.cpp.o
[  0%] Building CXX object 
lib/Demangle/CMakeFiles/LLVMDemangle.dir/MicrosoftDemangleNodes.cpp.o
[  0%] Linking CXX static library ../libLLVMDemangle.a
[  0%] Built target LLVMDemangle
Scanning dependencies of target LLVMSupport
[  0%] Building CXX object 
lib/Support/CMakeFiles/LLVMSupport.dir/AArch64TargetParser.cpp.o
[  0%] Building CXX object 
lib/Support/CMakeFiles/LLVMSupport.dir/ARMTargetParser.cpp.o
[  0%] Building CXX object 
lib/Support/CMakeFiles/LLVMSupport.dir/AMDGPUMetadata.cpp.o
[  0%] Building CXX object lib/Support/CMakeFiles/LLVMSupport.dir/APFloat.cpp.o
[  0%] Building CXX object lib/Support/CMakeFiles/LLVMSupport.dir/APInt.cpp.o

Do I need any additional config options?

Thanks,
Tanya

> On May 3, 2019, at 8:58 AM, Jonas Devlieghere  wrote:
> 
> Hey Tanya,
> 
> 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.
> 
> Thanks,
> Jonas
> 
> On Wed, May 1, 2019 at 10:40 PM Tanya Lattner  > wrote:
> I will give this a shot. I did remove the changes before to prevent any issue.
> 
> -Tanya
> 
>> On Apr 29, 2019, at 10:26 AM, Jonas Devlieghere > > wrote:
>> 
>> I've merged the aforementioned patch. 
>> 
>> Tanya, can you give generating the python docs another shot?
>> 
>> Thanks,
>> Jonas
>> 
>> On Fri, Apr 26, 2019 at 4:29 PM Jonas Devlieghere > > wrote:
>> I've put up a patch to make it possible to generate the python reference 
>> without building lldb at all: https://reviews.llvm.org/D61216 
>> 
>> 
>> PS: The website isn't updating anymore, is that because of the python 
>> reference generation?
>> 
>> On Wed, Apr 24, 2019 at 11:46 AM Ted Woodward > > wrote:
>> That's the issue - lldb-python-doc depends on liblldb. From 
>> docs/CMakeLists.txt:
>> 
>> if(EPYDOC_EXECUTABLE)
>>   find_program(DOT_EXECUTABLE dot)
>> if(DOT_EXECUTABLE)
>>   set(EPYDOC_OPTIONS ${EPYDOC_OPTIONS} --graph all --dotpath 
>> ${DOT_EXECUTABLE})
>> endif()
>> set(DOC_DIR "${CMAKE_CURRENT_SOURCE_DIR}/doc")
>> file(MAKE_DIRECTORY "${DOC_DIR}")
>> #set(ENV{PYTHONPATH} 
>> ${CMAKE_CURRENT_BINARY_DIR}/../../../lib/python2.7/site-packages)
>> add_custom_target(lldb-python-doc
>>   ${EPYDOC_EXECUTABLE}
>>   --html
>>   lldb
>>   -o ${CMAKE_CURRENT_BINARY_DIR}/python_reference
>>   --name "LLDB python API"
>>   --url "http://lldb.llvm.org "
>>   ${EPYDOC_OPTIONS}
>>   DEPENDS swig_wrapper liblldb
>>   WORKING_DIRECTORY 
>> ${CMAKE_CURRENT_BINARY_DIR}/../../../lib${LLVM_LIBDIR_SUFFIX}/python2.7/site-packages
>>   COMMENT "Generating LLDB Python API reference with epydoc" VERBATIM
>> )
>> endif(EPYDOC_EXECUTABLE)
>> 
>> 
>> > -Original Message-
>> > From: lldb-dev > > > On Behalf Of Pavel Labath
>> > via lldb-dev
>> > Sent: Wednesday, April 24, 2019 1:16 AM
>> > To: Jonas Devlieghere > > >; Tanya Lattner
>> > mailto:tanyalatt...@llvm.org>>
>> > Cc: LLDB mailto:lldb-dev@lists.llvm.org>>
>> > Subject: [EXT] Re: [lldb-dev] LLDB Website
>> > 
>> > On 24/04/2019 03:19, Jonas Devlieghere via lldb-dev wrote:
>> > >
>> > >
>> > > On Tue, Apr 23, 2019 at 6:04 PM Jonas Devlieghere
>> > > mailto:jo...@devlieghere.com> 
>> > > >> wrote:
>> > >
>> > >
>> > >
>> > > On Tue, Apr 23, 2019 at 5:43 PM Tanya Lattner > > > 
>> > > >> wrote:
>> > >
>> > >
>> > >
>> > >> On Apr 23, 2019, at 5:06 PM, Jonas Devlieghere
>> > >> mailto:jo...@devlieghere.com> 
>> > >> >> wrote:
>> > >>
>> > >>
>> > >>
>> > >> On Tue, Apr 23, 2019 at 5:00 PM Tanya Lattner
>> > >> mailto:tanyalatt...@llvm.org> 
>> > >> >> wrote:
>> > >>
>> > >>
>> > >>
>> > >>> On Apr 23, 2019, at 11:54 AM, Jonas Devlieghere
>> > >>> mailto:jo...@devlieghere.com> 
>> > >>> >>
>> > wrote:
>> > >>>
>> > >>> He