cleaned and documented debug options