tweaks to the documentation/comments for the mapgen function