Monitored: Improve deprecation warning and documentation

Use the warnings module for deprecation warnings as this includes the context (file/line) where the problem occured. Also update the doxygen documentation.