Added comments to parsetree.mli

Specifically, I documented some more obscure features that weren't obvious from reading the existing comments.
Discussion of these comments can be found on the mailing list at https://sympa.inria.fr/sympa/arc/caml-list/2014-04/msg00022.html