summaryrefslogtreecommitdiff
path: root/plugins/globalias/README.md
diff options
context:
space:
mode:
authorVectorW <15570764+VectorWpl@users.noreply.github.com>2020-10-11 21:23:21 +0200
committerGitHub <noreply@github.com>2020-10-11 21:23:21 +0200
commit82856bfbd86ac77f0f28ab741a399a04495ed3bc (patch)
treedeb70f321f4f2843c4b470fe0a163c06602b9f29 /plugins/globalias/README.md
parentfb80eb8e05e13cfb224114688fc7d20960e26b5f (diff)
downloadzsh-82856bfbd86ac77f0f28ab741a399a04495ed3bc.tar.gz
zsh-82856bfbd86ac77f0f28ab741a399a04495ed3bc.tar.bz2
zsh-82856bfbd86ac77f0f28ab741a399a04495ed3bc.zip
globalias: allow filtering values not to be expanded (#9331)
Diffstat (limited to 'plugins/globalias/README.md')
-rw-r--r--plugins/globalias/README.md19
1 files changed, 18 insertions, 1 deletions
diff --git a/plugins/globalias/README.md b/plugins/globalias/README.md
index 0b064105d..cd7fc3cb2 100644
--- a/plugins/globalias/README.md
+++ b/plugins/globalias/README.md
@@ -17,6 +17,9 @@ Then just press `SPACE` to trigger the expansion of a command you've written.
If you only want to insert a space without expanding the command line, press
`CTRL`+`SPACE`.
+if you would like to filter out any values from expanding set `GLOBALIAS_FILTER_VALUES` to
+an array of said values. See [Filtered values](#filtered-values).
+
## Examples
#### Glob expressions
@@ -37,7 +40,6 @@ $ ls folder/file.json anotherfolder/another.json
$ mkdir "`date -R`"
# expands to
$ mkdir Tue,\ 04\ Oct\ 2016\ 13:54:03\ +0300
-
```
#### Aliases
@@ -60,3 +62,18 @@ $ S<space>
# expands to:
$ sudo systemctl
```
+
+#### Filtered values
+
+```
+# .zshrc
+alias l='ls -lh'
+alias la='ls --color=auto -lah'
+GLOBALIAS_FILTER_VALUES=(l)
+
+$ l<space>
+# does not expand
+$ la<space>
+# expands to:
+$ ls --color=auto -lah
+```