aboutsummaryrefslogtreecommitdiff
path: root/book
diff options
context:
space:
mode:
authorOmnikar2021-08-31 09:13:16 +0000
committerGitHub2021-08-31 09:13:16 +0000
commite772808a5b0417e4d074eb9683d79376f83dae2d (patch)
treebd0b8f7011543d3592b51e5c0c260842118fade9 /book
parentdbfd054562ba97a73128c49fae0cea95deabec5d (diff)
Shell commands (#547)
* Implement shell interaction commands * Use slice instead of iterator for shell invocation * Default to `sh` instead of `$SHELL` for shell commands * Enforce trailing comma in `commands` macro * Use `|` register for shell commands * Move shell config to `editor` and use in command * Update shell command prompts * Remove clone of shell config * Change shell function names to match prompts * Log stderr contents upon external command error * Remove `unwrap` calls on potential common errors `shell` will no longer panic if: * The user-configured shell cannot be found * The shell command does not output UTF-8 * Remove redundant `pipe` parameter * Rename `ShellBehavior::None` to `Ignore` * Display error when shell command is used and `shell = []` * Document shell commands in `keymap.md`
Diffstat (limited to 'book')
-rw-r--r--book/src/keymap.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/book/src/keymap.md b/book/src/keymap.md
index 61378863..d85fb936 100644
--- a/book/src/keymap.md
+++ b/book/src/keymap.md
@@ -122,6 +122,16 @@ in reverse, or searching via smartcase.
| `[D` | Go to first diagnostic in document | `goto_first_diag` |
| `]D` | Go to last diagnostic in document | `goto_last_diag` |
+### Shell
+
+| Key | Description | Command |
+| ------ | ----------- | ------- |
+| `\|` | Pipe each selection through shell command, replacing with output | `shell_pipe` |
+| `A-\|` | Pipe each selection into shell command, ignoring output | `shell_pipe_to` |
+| `!` | Run shell command, inserting output before each selection | `shell_insert_output` |
+| `A-!` | Run shell command, appending output after each selection | `shell_append_output` |
+| `$` | Pipe each selection into shell command, removing if the command exits >0 | `shell_keep_pipe` |
+
## Select / extend mode
I'm still pondering whether to keep this mode or not. It changes movement