doc: dates subtraction has two functionalities
doc: fix example