[Libre-soc-bugs] [Bug 411] set up sphinx for all repos and upload to website

bugzilla-daemon at libre-soc.org bugzilla-daemon at libre-soc.org
Thu Jul 2 01:16:56 BST 2020


https://bugs.libre-soc.org/show_bug.cgi?id=411

--- Comment #3 from Luke Kenneth Casson Leighton <lkcl at lkcl.net> ---
(In reply to Jacob Lifshay from comment #1)
> We could also have a spot for hosting the rust docs for kazan and other rust
> libraries/programs.

ah good idea.

> Also, we would want to have autogenerated python
> documentation for our rust libraries that have python bindings.

yes.  as long as they all have docstrings this should work fine.

> If sphinx
> can't handle loading a python extension library then documenting it, we
> could use pdoc3, which is what I used to generate the python API docs for
> simple-soft-float.

i love epydoc.  it's the first of the docstring extractors.  sigh :)  except
the html it generates burns your eyes with primary colours.

sphinx's autodoc feature looks like someone caught optionitis.  tracking down
good examples there would be handy rather than spending days trying to read all
the options

-- 
You are receiving this mail because:
You are on the CC list for the bug.


More information about the libre-soc-bugs mailing list