[lldb-dev] [RFC] Using Sphinx to generate documentation

Jonas Devlieghere via lldb-dev lldb-dev at lists.llvm.org
Fri Dec 7 08:34:16 PST 2018


> On Dec 7, 2018, at 4:37 AM, Bruce Mitchener via lldb-dev <lldb-dev at lists.llvm.org> wrote:
> 
>> On Fri, Dec 7, 2018 at 6:11 PM Raphael Isemann via lldb-dev <lldb-dev at lists.llvm.org> wrote:
>> I think if we want to actually lower the entry barrier for
>> contributing/fixing things on the website, then the server should do
>> this. From what I know the other LLVM projects also generate the HTML
>> on the server (at least I've never seen anyone commit generated HTML
>> files), so this hopefully shouldn't be too complicated.

Yes, I definitely want to generate it. It should be straightforward to add a build bot that does this. I’ll see what is needed for this while I continue porting the other pages.

I’d like to have the doxygen and python documentation generated as well. The one that’s currently hosted on llvm.org is several years old, last time I checked. 

> Agree. Also, there's enough differences between the generated HTML for various versions of the tools that having it happen on the server would be good. 

I’d have to double check how llvm 

>  
>> I think in general this approach is really nice. Thanks a lot for the
>> work @Jonas!
> 
> Indeed!

My pleasure! I’m happy to see the positive reception here.

> 
>  - Bruce
> 
> _______________________________________________
> lldb-dev mailing list
> lldb-dev at lists.llvm.org
> http://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-dev
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/lldb-dev/attachments/20181207/3be2b751/attachment-0001.html>


More information about the lldb-dev mailing list