Document map options more thoroughly

Replacement for #1218 (only taken me 6 months to get around to it :-( )
Could `{@link ol.RendererHint}` here.