Hmm. I feel like the behaviour might be subtle enough to warrant an "Examples" section. But if you don't feel like writing one before we merge this, don't worry; we can just file a ticket for later, and have someone else do it (not necessarily you). It'd be a good CCW ticket for someone who needs to learn to use this.