Document our decoding/encoding scheme and set SHAPE_ENCODING.

The SHAPE_ENCODING config option forces OGR to decode using the
provided encoding instead trying to diagnose it.
Fixes for CRS serialization bugs pointed out by John Floyd.