removed really_exiting check as suggested in #627
Replaced function comment with doxygen-comment

Removed outdated comment, added deprecated flag.