Is there any way to give a better example?  I'm unclear when you'd want to use this, and it would be good if our docs gave a better indication.