map: split the map API into several sections in the doc

the main section with all functions converting between hwloc/port/server/netloc/name
is still too big