Document binding keys to a command (#647)

* Refactor `key_bindings` documentation

* Document binding keys to a `command`

The ability for `key_bindings` to trigger a `command` was added in #566.
This commit documents their use, and gives a simple example.

Resolves #646.

alacritty.yml

@@ -182,10 +182,14 @@ visual_bell:
 # capitalization must match exactly, and piped items must not have whitespace
 # around them.
 #
-# Either an `action` or `chars` field must be present. `chars` writes the
+# Either an `action`, `chars`, or `command` field must be present.
-# specified string every time that binding is activated. These should generally
+#   `action` must be one of `Paste`, `PasteSelection`, `Copy`, or `Quit`.
-# be escape sequences, but they can be configured to send arbitrary strings of
+#   `chars` writes the specified string every time that binding is activated.
-# bytes. Possible values of `action` include `Paste` and `PasteSelection`.
+#     These should generally be escape sequences, but they can be configured to
+#     send arbitrary strings of bytes.
+#   `command` must be a map containing a `program` string, and `args` array of
+#     strings. For example:
+#     - { ... , command: { program: "alacritty", args: ["-e", "vttest"] } }
 #
 # Want to add a binding (e.g. "PageUp") but are unsure what the X sequence
 # (e.g. "\x1b[5~") is? Open another terminal (like xterm) without tmux,

alacritty_macos.yml

@@ -182,10 +182,14 @@ visual_bell:
 # capitalization must match exactly, and piped items must not have whitespace
 # around them.
 #
-# Either an `action` or `chars` field must be present. `chars` writes the
+# Either an `action`, `chars`, or `command` field must be present.
-# specified string every time that binding is activated. These should generally
+#   `action` must be one of `Paste`, `PasteSelection`, `Copy`, or `Quit`.
-# be escape sequences, but they can be configured to send arbitrary strings of
+#   `chars` writes the specified string every time that binding is activated.
-# bytes. Possible values of `action` include `Paste` and `PasteSelection`.
+#     These should generally be escape sequences, but they can be configured to
+#     send arbitrary strings of bytes.
+#   `command` must be a map containing a `program` string, and `args` array of
+#     strings. For example:
+#     - { ... , command: { program: "alacritty", args: ["-e", "vttest"] } }
 key_bindings:
   - { key: V,        mods: Command, action: Paste                        }
   - { key: C,        mods: Command, action: Copy                         }