From c753391f43a506d24043708743acd13446b04b60 Mon Sep 17 00:00:00 2001
From: Matthew Hooker <mwhooker@gmail.com>
Date: Fri, 13 Apr 2018 20:08:22 -0700
Subject: [PATCH] fill out and reformat the boot command docs

---
 .../partials/builders/_boot-command.html.md   | 50 +++++++++----------
 1 file changed, 25 insertions(+), 25 deletions(-)

diff --git a/website/source/partials/builders/_boot-command.html.md b/website/source/partials/builders/_boot-command.html.md
index e4e206cae..a8dc570a0 100644
--- a/website/source/partials/builders/_boot-command.html.md
+++ b/website/source/partials/builders/_boot-command.html.md
@@ -5,54 +5,53 @@ command, they will be replaced by the proper key:
 
 -   `<del>` - Delete
 
--   `<enter>` and `<return>` - Simulates an actual "enter" or "return" keypress.
+-   `<enter> <return>` - Simulates an actual "enter" or "return" keypress.
 
 -   `<esc>` - Simulates pressing the escape key.
 
 -   `<tab>` - Simulates pressing the tab key.
 
--   `<f1>` - `<f12>` - Simulates pressing a function key.
+-   `<f1> - <f12>` - Simulates pressing a function key.
 
--   `<up>` `<down>` `<left>` `<right>` - Simulates pressing an arrow key.
+-   `<up> <down> <left> <right>` - Simulates pressing an arrow key.
 
 -   `<spacebar>` - Simulates pressing the spacebar.
 
 -   `<insert>` - Simulates pressing the insert key.
 
--   `<home>` `<end>` - Simulates pressing the home and end keys.
+-   `<home> <end>` - Simulates pressing the home and end keys.
 
--   `<pageUp>` `<pageDown>` - Simulates pressing the page up and page down keys.
+-   `<pageUp> <pageDown>` - Simulates pressing the page up and page down keys.
 
--   `<leftAlt>` `<rightAlt>` - Simulates pressing the alt key.
+-   `<leftAlt> <rightAlt>` - Simulates pressing the alt key.
 
--   `<leftCtrl>` `<rightCtrl>` - Simulates pressing the ctrl key.
+-   `<leftCtrl> <rightCtrl>` - Simulates pressing the ctrl key.
 
--   `<leftShift>` `<rightShift>` - Simulates pressing the shift key.
+-   `<leftShift> <rightShift>` - Simulates pressing the shift key.
 
--   `<leftAltOn>` `<rightAltOn>` - Simulates pressing and holding the alt key.
+-   `<leftSuper> <rightSuper>` - Simulates pressing the ⌘ or Windows key.
 
--   `<leftCtrlOn>` `<rightCtrlOn>` - Simulates pressing and holding the ctrl key.
-
--   `<leftShiftOn>` `<rightShiftOn>` - Simulates pressing and holding the shift key.
-
--   `<leftAltOff>` `<rightAltOff>` - Simulates releasing a held alt key.
+-   `<wait> <wait5> <wait10>` - Adds a 1, 5 or 10 second pause before
+    sending any additional keys. This is useful if you have to generally wait
+    for the UI to update before typing more.
 
--   `<leftCtrlOff>` `<rightCtrlOff>` - Simulates releasing a held ctrl key.
+-   `<waitXX>` - Add an arbitrary pause before sending any additional keys. The
+    format of `XX` is a possibly signed sequence of decimal numbers, each with
+    optional fraction and a unit suffix, such as `300ms`, `-1.5h` or `2h45m`.
+    Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`. For example
+    `<wait10m>` or `<wait1m20s>`
 
--   `<leftShiftOff>` `<rightShiftOff>` - Simulates releasing a held shift key.
 
--   `<wait>` `<wait5>` `<wait10>` - Adds a 1, 5 or 10 second pause before
-    sending any additional keys. This is useful if you have to generally wait
-    for the UI to update before typing more.
+### On/Off variants
 
--   `<waitXX>` - Add user defined time.Duration pause before sending any
-    additional keys. For example `<wait10m>` or `<wait1m20s>`
+Any printable keyboard character, and of these "special" expressions, with the
+exception of the `<wait>` types, can also be toggled on or off. For example, to
+simulate ctrl+c, use `<leftCtrlOn>c<leftCtrlOff>`. Be sure to release them,
+otherwise they will be held down until the machine reboots.
 
-When using modifier keys `ctrl`, `alt`, `shift` ensure that you release them,
-otherwise they will be held down until the machine reboots. Use lowercase
-characters as well inside modifiers.
+To hold the `c` key down, you would use `<cOn>`. Likewise, `<cOff>` to release.
 
-For example: to simulate ctrl+c use `<leftCtrlOn>c<leftCtrlOff>`.
+### Templates inside boot command
 
 In addition to the special keys, each command to type is treated as a
 [template engine](/docs/templates/engine.html). The
@@ -62,6 +61,7 @@ available variables are:
     that is started serving the directory specified by the `http_directory`
     configuration parameter. If `http_directory` isn't specified, these will be
     blank!
+*   `Name` - The name of the VM.
 
 For more examples of various boot commands, see the sample projects from our
 [community templates page](/community-tools.html#templates).