Document and clean up the character map building process
Document the case where we give up on decoding text as Windows-1252.

This includes fixing an inaccurate comment that appeared after it.