Skip to content

Build requirements are not properly documented

Currently the build instructions in README.md and INSTALL are missing a lot of very important information that should be added:

  • An internet connection is needed because pip is used to download python packages.
  • When no connection is available, one gets several warnings and error messages. However, the build seems to terminate successfully. Furthermore CMake says that the optional package Python3has been found. Either this is not a problem and the build is successful, then we should not scare users with these error messages. Or this means that the python-bindings cannot be used than this should be properly reported to the user.
  • If the internet connection is available, it is used to download executable code from third party locations that is executed later.
  • Since the required python modules are not documented it's also not possible that the user provides them on his own to avoid this dangerous behavior. Notice that even if the python packages mentioned in the error messages are installed globally, the attempt to download them and the mentioned error messages persists.

BTW: One can argue that downloading and executing code from third party locations is a no-go unless the user explicitly opts in. This ticket is not about changing this behavior now. But we should at least be honest and clearly document this and tell the users how it can be disabled.