Little documentation updates
Add some more comments to slurp method in parser

Per @eturk's suggestions.