Updates to completion & edits for widgets and line movement

Author: rothgar

Diff for: docs/helpers/bindkey.md

@@ -3,6 +3,9 @@
 The `bindkey` key mappings can be very confusing to decipher.
 It can use multiple different notations but it's smart to use the same key notation throughout your configuration.
 
+You can print all of your current key bindings in the current keymap with `bindkey`.
+To print the full `bindkey` command to add to your `.zshrc` file use `bindkey -L`.
+
 In general you'll bind a widget so a key sequence or a key with modifier.
 This can be declared in (caret notation)[https://en.wikipedia.org/wiki/Caret_notation] using `^`, using (escape sequences)[https://en.wikipedia.org/wiki/Escape_sequence] using `\`, in octal (`\NNN`), hex (`\xNN`), or unicode (`\uNNNN`).
 None of these are particularly great for people to read.

Diff for: docs/helpers/completions.md

@@ -1,19 +1,45 @@
 # [WIP] Completions
 
-https://github.com/zsh-users/zsh-completions
+zsh has very comprehensive completions which is one of the main reasons to switch to zsh for your interactive shell.
+Under the covers it works similarly to other shell completion engines (completions are read from files and functions on disc) but there are a few features that make it better.
+
+> Some of the completion features have been ported to other shells and some have been stolen from other shells.
+> Many of the sections below are optional to enhance your shell experience.
+
+One nice difference is the way completions are displayed and how tab works when at a completion menu.
+Here is a comparison with how `bash` and `zsh` differ.
+
+![](../../img/bash-completion.gif)
+
+There are lots of commands that have built in tab completion for zsh.
+If a command you use doesn't support tab completion by default have a look at [zsh-users/zsh-completions](https://github.com/zsh-users/zsh-completions).
+You can install it with the various zsh plugin managers or download the repo and add the src directory to your `$fpath`.
 
 ## Autosuggestions
 
-https://github.com/zsh-users/zsh-autosuggestions
+Autosuggestions are like a preemptive tab complete for your .zhistory file.
+The autosuggestion plugin will look at your current command, what commands you typically type, and suggest possibilities for you to use and save key strokes.
+
+Installation instructions can be found in the [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions) repo.
+
+![](../../img/autosuggestions.gif)
 
 ## Highlighting
 
-https://github.com/zsh-users/zsh-syntax-highlighting
+Syntax highlighting works similarly to an IDE but at your terminal.
+It can highlight everything from brackets to cursor position.
+
+Under the covers it works like all the other things in zsh with zle widgets.
+Have a look at the [zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting) repo for installation instructions
+
+![](../../img/highlighting.gif)
 
 ## zstyle
 
 List your current styles by invoking `zstyle` by itself.
 
+The rest of this section will have to come at a later date.
+
 ---
 
 [home](../../README.md)

Diff for: docs/helpers/widgets.md

@@ -15,16 +15,15 @@ You can list all available widgets with
 zle -al
 ```
 
-If you want to list your current keybindings and widgets use.
-
-```bash
-bindkey
-```
+If you want to list your current keybindings and widgets use the `bindkey` command by itself.
+To see a list of bindings and a command you can run to set the key binding in your `.zshrc` file use `bindkey -L`
 
 The widgets with `.` at the begining of the name are read-only system widgets that cannot be changed.
 
 An example of binding a built in widget to a keyboard shortcut is
 
+> When you bind a key to a widget the privious key binding, if there is one, will be overridden.
+
 ```bash
 bindkey '^a' begining-of-line
 ```

Diff for: docs/usage/line_movement.md

@@ -31,7 +31,7 @@ For reference:
 * `^[` = Alt
 * `\e` or `\E` = Escape
 
-If you want to figure out how a key sequence should be represented check out `xxd`.
+If you want to figure out how a key sequence should be represented you can try `xxd` or `echo " $keypress"`.
 The key letter you press is not case sensitive.
 So `^a` is the same as `^A`.
 
@@ -48,6 +48,8 @@ Let's set the emacs begining and end of line keyboard shortcuts and reverse sear
 bindkey '^r' history-incremental-search-backward
 bindkey '^a' beginning-of-line
 bindkey '^e' end-of-line
+# Also fix annoying vi backspace
+bindkey '^?' backward-delete-char
 ```
 
 Now I have four ways to get to the begining and end of a command line.