document the new scala fns