a lot of parser commenting updates. clarified a lot of whats going on. maybe not essential since nothing in there us part of the public API, but makes me feel nicer aboue Wookie.