docs: public static HashMap merge(Map map1, Map map2)
      {
          HashMap retval = new HashMap(calcCapacity(map1.size() + map2.size()));
  
          retval.putAll(map1);
          retval.putAll(map2);
  
          return retval;
      }