It might be nice to start this out with *why* a user might want to do this, maybe a common use case. I'm not sure if that is documented elsewhere though.