openmano-mpy/docs/Makefile, branch master

docs: Fix Sphinx 3.x warnings, and enable warnings-as-errors on build.

2020-06-05T11:42:17+00:00

This enables warnings as errors and fixes all current errors, namely:

- reference to terms in the glossary must now be explicit (:term:)
- method overloads must not be declared as a separate method or must
  use :noindex:
- 2 cases where `` should have been used instead of `

docs/Makefile: define and use PYTHON as the interpreter for CPYDIFF

2017-02-27T04:39:55+00:00

User can override PYTHON executable before running script,
gen-cpydiff.py works only with Python3 and most systems register
its executable as 'python3'.

docs: Modify Makefile and indexes to generate cPy-differences pages.

2017-02-20T06:14:35+00:00

docs: Rebuild docs from scratch, as required for proper only:: handling.

2016-06-13T21:23:33+00:00

Docs are now by default rebuilt from scratch, as required to build
conditionalized (i.e. using only:: directive) docs across different
output types. We have pretty small docset, so that's still rather fast.
However, if that's a concern, incremental rebuilds can be used by
passing "FORCE=" (nothing after =) as a make parameter. This will work
when using the same output type (e.g. only "html").

docs/Makefile: Default BUILDDIR based on MICROPY_PORT.

2016-04-26T22:50:05+00:00

It doesn't make sense to duplicate both on command line, and MICROPY_PORT
is effectively mandatory to build docs.

docs: Initial commit of Sphinx documentation framework.

2014-09-25T16:23:06+00:00