Giters

alphaville / optimization-engine

Nonconvex embedded optimization: code generation for fast real-time optimization

Home Page:https://alphaville.github.io/optimization-engine/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Sphinx-proof docstrings

alphaville opened this issue · comments

commented

Describe the bug 🐞

Make docstrings sphinx-compliant (including LaTeX). Currently, make html gives the following warning:

/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/build_config.py:docstring of opengen.config.build_config.BuildConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/build_config.py:docstring of opengen.config.build_config.BuildConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/build_config.py:docstring of opengen.config.build_config.BuildConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/build_config.py:docstring of opengen.config.build_config.BuildConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/build_config.py:docstring of opengen.config.build_config.BuildConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/build_config.py:docstring of opengen.config.build_config.BuildConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/build_config.py:docstring of opengen.config.build_config.BuildConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/build_config.py:docstring of opengen.config.build_config.BuildConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/meta.py:docstring of opengen.config.meta.OptimizerMeta:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/solver_config.py:docstring of opengen.config.solver_config.SolverConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/config/solver_config.py:docstring of opengen.config.solver_config.SolverConfiguration:1: WARNING: Field list ends without a blank line; unexpected unindent.
/Users/3054363/Documents/Development/OpEn/open-codegen/venv/lib/python3.8/site-packages/opengen/constraints/simplex.py:docstring of opengen.constraints.simplex.Simplex:1: WARNING: Field list ends without a blank line; unexpected unindent.

To Reproduce 🛠️

cd sphinx-dox
make clean
make html