adding docu for prev_value