Document map options more thoroughly
Merge pull request #2138 from probins/mapoptions

Document map options more thoroughly