Doc fixes for opm-core

This fixes some of the more visible omissions, errors and glitches in the opm-core docs.