The documentation on this function can probably be improved a bit as we are no longer just returning the changed values.