improve verbose mode, add commentary