Full code review

Add a comment (both here and in a seaparate README) describing the input file format.