From 0394ca7ea5717e2044e59a9738c6d7bc072308af Mon Sep 17 00:00:00 2001
From: Andrew Radev <andrey.radev@gmail.com>
Date: Mon, 22 Aug 2016 21:40:09 +0300
Subject: [PATCH] Documentation

---
 doc/ember_tools.txt | 75 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/doc/ember_tools.txt b/doc/ember_tools.txt
index 709292e..6cf8ae8 100644
--- a/doc/ember_tools.txt
+++ b/doc/ember_tools.txt
@@ -197,6 +197,81 @@ emblem template, but if you'd like to specify explicitly what templates you
 prefer, set the |g:ember_tools_default_logic_filetype| and/or
 |g:ember_tools_default_template_filetype| configuration variables.
 
+                                                          *ember_tools-:Unpack*
+:Unpack ~
+
+The `:Unpack` command helps you unpack an imported variable into its component
+pieces. An example might looks something like this:
+
+>
+    import Ember from 'ember';
+
+    export default Ember.Controller.extend({
+      foo: Ember.computed.equal('bar', 'baz')
+    });
+<
+Running the `:Unpack` command with the cursor on "Ember.Controller" would lead
+to the following result:
+>
+    import Ember from 'ember';
+
+    const { Controller } = Ember;
+
+    export default Controller.extend({
+      foo: Ember.computed.equal('bar', 'baz')
+    });
+<
+The command creates a `const { ... } = ` line that unpacks the `Ember`
+variable's `Controller` component into its own variable.
+
+You can continue to run `:Unpack` on, for instance, "Ember.computed.equal",
+and then once again on the remaining "computed.equal" (if you have repeat.vim
+installed, you can just trigger the |.| mapping) to get:
+>
+    import Ember from 'ember';
+
+    const { Controller, computed } = Ember;
+    const { equal } = computed;
+
+    export default Controller.extend({
+      foo: equal('bar', 'baz')
+    });
+<
+The command adds new entries to the end of the list. If you'd like to sort
+them in some way afterwards, you can try using a different plugin of mine,
+sideways (https://github.com/AndrewRadev/sideways.vim).
+
+                                                          *ember_tools-:Inline*
+:Inline ~
+
+The `:Inline` command inlines an "unpacked" variable. If you have code like
+this:
+>
+    import Ember from 'ember';
+
+    const { computed, Controller } = Ember;
+
+    export default Controller.extend({
+      foo: computed.equal('bar', 'baz')
+      bar: computed.equal('baz', 'qux')
+    });
+<
+Running `:Inline` on "computed" within the `const { ... }` definition will
+remove it from that list and replace it across the file (ignoring strings and
+comments) with "Ember.computed".
+>
+    import Ember from 'ember';
+
+    const { Controller } = Ember;
+
+    export default Controller.extend({
+      foo: Ember.computed.equal('bar', 'baz')
+      bar: Ember.computed.equal('baz', 'qux')
+    });
+<
+For now, this is simply a reversal of the `:Unpack` command. In the future,
+the `:Inline` command might also inline other kinds of constructs, like local
+variables or properties.
 
 
 ==============================================================================