document default behavior. make argument const.