shelve should show diff

"bzr shelve" is a verb to store a diff as a new change elsewhere, but is also access to the suite of shelving stats. When committing, we get a nice message,

2 shelves exist. See "bzr shelve --list" for details.

Awesome.

But, unless you stored a -m'essage with the shelved diff, it's not very helpful. You have to see the diff itself to know what the changes are.

And for that, you have to know that the programmer thought of the internals of unshelving but not applying the diff to the source as the only way to see the diff. "bzr unshelve --preview"? That's not close to listing shelves. Discoverabilty nightmare.

So, "bzr shelve --list" should emit a message about how to see what the diffs are, and it should not be so weird as "preview". Make it part of the "bzr shelve" commands.

I suggest

bzr shelve --show N # show diff of #N.
bzr shelve --show # to show all
bzr shelve --list --show-diff # parity with "bzr log"!

and a new message with "bzr shelve --list" that points to how to find out more about the contents of a shelf or shelves.