Incomplete documentation of "bzr shelve"

The documentation of "bzr shelve" has a few omissions:

 - It does not say that the user will be asked whether to shelve each individual hunk of changes.
 - It does not document the single-letter responses (yNfq?) to the question. At least "f" is not obvious, and neither is whether "?" is part of the prompt or a valid response.
 - It does not tell what is "--message" used for; you only understand that when you use "shelve --list" later, when it's too late.
 - It describes something called "writer" which is not mentioned anywhere in the command's documentation.

By the way, the documentation included with the Help file of Bazaar 2.4.1 seems to be outdated: "bzr help shelve" tells more.