Fix miswording in data specs doc.
Make code listing more compact.
Draw more attention to 'incorrect'.
Merge pull request #691 from dwf/fix_data_specs_doc

Fix miswording in data specs doc.