Improved documentation in parser.c/h and cleaned up some code in the
modified files. Updated the README introduction.