add deprecated warning for deleteState functions
add doxygen comments
mod comment
complete doxygen comment