documenting the junky merge syntax