Improve documentation

#109 changes the behavior of what is described with the last sentence. Given my last comment in #111, I will update it one way or another depending on the decision.