tweak debug documentation and calls