Document map options more thoroughly

Replacement for #1218 (only taken me 6 months to get around to it :-( )