parser cleanup:  split some long lines, improve a couple error messages, fix up comments and doc-strings
remove form-feed ('\f') as newline character from spec, implementation, and tests