add explicit note that map_path() does not communicate with the master
a few docstring syntax fixes