cleaned up the reader prototype and some (vague) documentation.