Can you please better document what happens if you provide a real value and if you provide `null`?