improved parser documentation and testing