There is no documentation on how to configure shelve to use external editor

[Alexander Belchenko]

Aaron Bentley said that new feature for shelve command to invoke external editor for selecting changes to keep/shelving was merged to bzr 2.1.0b3, but in 2.1.0rc1 I found no documentation on how to use it.

Thanks to Aaron help in IRC it's require to add the line below to configuration file (bazaar.conf or branch one):

change_editor = vimdiff -fo @new_path @old_path

There: "@new_path" is replaced with the path of the new version of the file, "@old_path" is replaced with the path of the old version of the file.

So user supposed to edit new version of the file to get the desired end result.

After change_editor has configured `bzr shelve` in its hunk help provides new choice: "e" letter to invoke specified editor.