to be clear by the way when I say "javadoc" I mean something more substantial than this. It needs to explain what the class's purpose is to someone not familiar with the code or the parser. What's a dynamic record? what does it mean for a state to start parsing? etc. It also needs to either explain the purpose of all the fields in the class, or defer that task to javadoc on the fields themselves.