* Add helper function/decorator for deprecation warning

This logs warnings about deprecated functions and also shows the
filename as well as the linenumber.

* enhance documentation

* try to fix python3 (blindly)

* deprecation: use one function to log and one function as decorator

* fix linting