added notes for usage, debug mode