Documentation for renaming keys

[mjgiarlo]

The compose tasks section of the README currently suggests using the deprecated tree-rename-key command to remove all keys in one locale that do not exist in another:

$ i18n-tasks missing -t diff -f yaml en | i18n-tasks tree-rename-key en fr | i18n-tasks data-remove

Invoking the same commands using tree-mv instead of tree-rename-key, however, does not yield the expected results. If e.g. removing crufty de keys based on en, I'd expect the output of the second operation in the pipe to show the root key changing from en to de; instead, I see:

en:
  de:
    etc:

Upon a very quick inspection, it seems this may be caused by root: false here:

i18n-tasks/lib/i18n/tasks/command/commands/tree.rb

Line 71 in 2070f08

forest.mv_key!(compile_key_pattern(from_pattern), to_pattern, root: false)

(I am using tree-rename-key for my needs in the meantime, so I don't currently have cycles to try tweaking root to true to see what happens.)

[glebm]

Seems like a bug, all tree- commands should accept full keys (with root: true).

[mjgiarlo]

Thanks, @glebm!