groundwork for --update-map