print statement fixes

convert the print statement to a WARN level log line or to a call to the print
function, depending on the context.
'floating' docstring fixes

move module docstrings to the top of the module
convert some 'docstrings' to comments
remove useless docs
please flake8 about blank lines