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
>>> > >> (sudo pip install epydoc).
>>> > >> 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`.
>>> > >>
>>> > >>
