diff --git a/modules/python/doc/conf.py.in b/modules/python/doc/conf.py.in index c4e8ea6c2c..d1d18ac7cf 100644 --- a/modules/python/doc/conf.py.in +++ b/modules/python/doc/conf.py.in @@ -16,7 +16,7 @@ # documentation root, use os.path.abspath to make it absolute, like shown here. import sys import os - +from datetime import date # If your documentation needs a minimal Sphinx version, state it here. # needs_sphinx = '1.0' @@ -91,6 +91,14 @@ version = "@VISP_PYTHON_VERSION@" # The full version, including alpha/beta/rc tags. release = "@VISP_PYTHON_VERSION@" +BUILD_DAILY_DOC = os.getenv('BUILD_DAILY_DOC') +if BUILD_DAILY_DOC != None: + print("Create doc for daily build") + today = date.today() + release = "@VISP_PYTHON_VERSION@ under development (" + str(today) + ")" +else: + print("Create doc for release") + # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. # diff --git a/modules/python/doc/rst/known_issues.rst b/modules/python/doc/rst/known_issues.rst index a469289ba1..9f843a6db8 100644 --- a/modules/python/doc/rst/known_issues.rst +++ b/modules/python/doc/rst/known_issues.rst @@ -13,18 +13,18 @@ Usability No implicit conversion from ViSP types to Numpy ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Numpy array cannot be implicitely converted to a ViSP representation when calling a ViSP function. +Numpy array cannot be implicitly converted to a ViSP representation when calling a ViSP function. ViSP 3rd party types (such as cv::Mat) cannot be used from Python ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ We do not interface with other bindings (as it is not trivial and may require specific Pybind ABI), and we do not wrap third party types. -Thus, alternatives must be provided by hand into the ViSP API (or wrapped through custom bindings) so that the functionalities can be used from Python +Thus, alternatives must be provided by hand into the ViSP API (or wrapped through custom bindings) so that the functionalities can be used from Python. Cannot inherit from a ViSP class in Python ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Right now, it is not possible to inherit from a ViSP class with a Python class. Virtual methods cannot be overriden. -To remedy this, trampoline classes should be implemented into the generator, either fully automated (but that is a lot of complexity) +To remedy this, trampoline classes should be implemented into the generator, either fully automated (but that is complex) or by providing the trampoline by hand and adding a way to reference the trampoline class in the configuration file.