Currently there are **128** warnings:
[ ] more than one target found for cross-reference (124): we should be more specific in `@type param: Page` and similar, partially #Upstream as some of these should prefer local file method over another file's
[ ] Literal block expected; none found (1 in category): ":" before paragraph, not before indented text. It is processed to "::" by conf.py, therefore throws these warnings
[ ] test command found but not installed in testenv (1): from testenv
These errors make doc build for the issued scripts fail completely (therefore files missing in docs):
[] failed to import module (2: lua in script_wui.py and _tkinter in userinterfaces/gui.py): probably not possible to solve
Errors and warnings can be easily tested on:
- [[http://rst.ninjs.org/#|reST]]
- [[https://livesphinx.herokuapp.com/|Sphinx]]
- no online editor found for epytext yet, the two above should do
Note: Don't forget to process raw docstring to " -" and "::" before pasting to the editors above, see docs/conf.py for more details
Below is the somewhat last whole documentation build with all the remaining warnings:
{P6679, lines=10}