added run() and debug() to documentation