Rename ShapeData checker and document

Rename correctShapeData to the less ambiguous "normalizeShapeData"
and document its operations on the passed ShapeData object
reference.