Examples are a good idea, but then we'll have to add examples everywhere to be consistent. For now I suggest you at least add the option in the Usage paragraph above.