[lldb-dev] LLDB API Docs on the WWW?
daniel.malea at intel.com
Tue Jun 25 11:41:06 PDT 2013
One of the great things about LLDB is the API — both C++ and Python. Recently, I added some targets that generate HTML documentation for the Python module and C++ headers, but it's still somewhat cumbersome to use locally:
$ ninja lldb-python-doc lldb-cpp-doc
$ firefox tools/lldb/doc/.………./index.html
<navigate using links and other antiquated searches>
Whereas for LLVM docs, I just google "llvm module" and the first hit is the right documentation page. It would be great if I could just google "lldb SBTarget" and see the SBTarget docs.
So, do people think this would be a good idea; to have LLDB HTML docs somewhere Google can find them?
If so, does manually checking in some directories of generated HTML into lldb/www sound ok? Eventually, it would be nice to have the docs auto-generated by a buildbot or equivalent, but for the time being I think this is sufficient.
Also, what about internals? Do we want the docs to contain stuff in lldb/source or just lldb/include? It does make a difference on the final size of the docs:
With internals ('include' + 'source directories'): ~574MB
Without internals (only 'include' directory): ~157MB
Most of the above is png inheritance diagrams…
As for the python stuff, when generated by epydoc, is a little bit smaller and weighs in at only 14MB
Anyways, let me know what you guys think. Is www the right place to put CPP/Python reference docs? Should I exclude internals?
More information about the lldb-dev