Beef up parser for human-readability in files, with test
Add mention of spec in README