From ce1a0eaa58f7ad07c5389996a90c4b02bdf573fc Mon Sep 17 00:00:00 2001 From: johannst Date: Mon, 13 Apr 2020 19:02:58 +0000 Subject: deploy: 43e402ba2320ced7972d33c9442b2745afe230f6 --- awk.html | 2 +- bash.html | 41 +++++-- c++.html | 2 +- c++filt.html | 2 +- emacs.html | 2 +- fish.html | 2 +- gcc.html | 2 +- gdb.html | 2 +- git.html | 2 +- glibc.html | 2 +- index.html | 2 +- ld.so.html | 2 +- lsof.html | 2 +- nm.html | 2 +- objdump.html | 2 +- od.html | 2 +- oprofile.html | 2 +- perf.html | 2 +- pgrep.html | 2 +- pidstat.html | 2 +- print.html | 138 ++++++++++++++++++++++-- pstack.html | 2 +- radare2.html | 2 +- readelf.html | 2 +- searchindex.js | 2 +- searchindex.json | 2 +- strace.html | 2 +- time.html | 2 +- tmux.html | 6 +- xxd.html | 2 +- zsh.html | 320 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 31 files changed, 515 insertions(+), 44 deletions(-) create mode 100644 zsh.html diff --git a/awk.html b/awk.html index 187e2e9..d9542a8 100644 --- a/awk.html +++ b/awk.html @@ -81,7 +81,7 @@ diff --git a/bash.html b/bash.html index 9f47774..87a909f 100644 --- a/bash.html +++ b/bash.html @@ -81,7 +81,7 @@ @@ -251,18 +251,43 @@ COMP_CWORD # index into COMP_WORDS with current cursor position # out COMPREPLY # array with possible completions -

compgen builtin is used to generate possible matches for word out of possible options. -The syntax is as follows:

+

The compgen builtin is used to generate possible matches by comparing word +against words generated by option.

compgen [option] [word]
 
 # usefule options:
+# -W <list>    specify list of possible completions
+# -d           generate list with dirs
+# -f           generate list with files
+# -u           generate list with users
+# -e           generate list with exported variables
 
-# -W <list>    compare against word-list
+# compare "f" against words "foo" "foobar" "bar" and generate matches
 compgen -W "foo foobar bar" "f"
 
-# -d    compare against dir names
-# -f    compare against file names
+# compare "hom" against file/dir names and generate matches
 compgen -d -f "hom"
+
+

Example

+

Skeleton to copy/paste for writing simple completions.

+

Assume a program foo with the following interface:

+
foo -c green|red|blue -s low|high -f <file> -h
+
+

The completion handler could be implemented as follows:

+
function _foo() {
+    local curr=$2
+    local prev=$3
+
+    local opts="-c -s -f -h"
+    case $prev in
+        -c) COMPREPLY=( $(compgen -W "green red blue" -- $curr) );;
+        -s) COMPREPLY=( $(compgen -W "low high" -- $curr) );;
+        -f) COMPREPLY=( $(compgen -f -- $curr) );;
+        *)  COMPREPLY=( $(compgen -W "$opts" -- $curr) );;
+    esac
+}
+
+complete -F _foo foo
@@ -276,7 +301,7 @@ compgen -d -f "hom" - @@ -294,7 +319,7 @@ compgen -d -f "hom" - diff --git a/c++.html b/c++.html index 296cde0..8dc9708 100644 --- a/c++.html +++ b/c++.html @@ -81,7 +81,7 @@ diff --git a/c++filt.html b/c++filt.html index 1827d50..e8966ff 100644 --- a/c++filt.html +++ b/c++filt.html @@ -81,7 +81,7 @@ diff --git a/emacs.html b/emacs.html index 3064ffd..382f68a 100644 --- a/emacs.html +++ b/emacs.html @@ -81,7 +81,7 @@ diff --git a/fish.html b/fish.html index ec5722d..e9c64b7 100644 --- a/fish.html +++ b/fish.html @@ -81,7 +81,7 @@ diff --git a/gcc.html b/gcc.html index 7a7e192..196ab3a 100644 --- a/gcc.html +++ b/gcc.html @@ -81,7 +81,7 @@ diff --git a/gdb.html b/gdb.html index 247214f..c1e69e2 100644 --- a/gdb.html +++ b/gdb.html @@ -81,7 +81,7 @@ diff --git a/git.html b/git.html index 703655f..1e67d95 100644 --- a/git.html +++ b/git.html @@ -81,7 +81,7 @@ diff --git a/glibc.html b/glibc.html index 422a28d..cf2e12a 100644 --- a/glibc.html +++ b/glibc.html @@ -81,7 +81,7 @@ diff --git a/index.html b/index.html index afbe802..4a46822 100644 --- a/index.html +++ b/index.html @@ -81,7 +81,7 @@ diff --git a/ld.so.html b/ld.so.html index 38c61a3..8b18d0f 100644 --- a/ld.so.html +++ b/ld.so.html @@ -81,7 +81,7 @@ diff --git a/lsof.html b/lsof.html index efd2976..4e41ede 100644 --- a/lsof.html +++ b/lsof.html @@ -81,7 +81,7 @@ diff --git a/nm.html b/nm.html index 0a7212f..1285efd 100644 --- a/nm.html +++ b/nm.html @@ -81,7 +81,7 @@ diff --git a/objdump.html b/objdump.html index 497ffe5..3356705 100644 --- a/objdump.html +++ b/objdump.html @@ -81,7 +81,7 @@ diff --git a/od.html b/od.html index 473a03f..7b838b1 100644 --- a/od.html +++ b/od.html @@ -81,7 +81,7 @@ diff --git a/oprofile.html b/oprofile.html index 842835f..8379b96 100644 --- a/oprofile.html +++ b/oprofile.html @@ -81,7 +81,7 @@ diff --git a/perf.html b/perf.html index b817906..9e378b7 100644 --- a/perf.html +++ b/perf.html @@ -81,7 +81,7 @@ diff --git a/pgrep.html b/pgrep.html index a80ae5d..3e862cf 100644 --- a/pgrep.html +++ b/pgrep.html @@ -81,7 +81,7 @@ diff --git a/pidstat.html b/pidstat.html index d4d9849..ee411d1 100644 --- a/pidstat.html +++ b/pidstat.html @@ -81,7 +81,7 @@ diff --git a/print.html b/print.html index d1b2fbb..66f1ebe 100644 --- a/print.html +++ b/print.html @@ -83,7 +83,7 @@ @@ -469,19 +469,145 @@ COMP_CWORD # index into COMP_WORDS with current cursor position # out COMPREPLY # array with possible completions -

compgen builtin is used to generate possible matches for word out of possible options. -The syntax is as follows:

+

The compgen builtin is used to generate possible matches by comparing word +against words generated by option.

compgen [option] [word]
 
 # usefule options:
+# -W <list>    specify list of possible completions
+# -d           generate list with dirs
+# -f           generate list with files
+# -u           generate list with users
+# -e           generate list with exported variables
 
-# -W <list>    compare against word-list
+# compare "f" against words "foo" "foobar" "bar" and generate matches
 compgen -W "foo foobar bar" "f"
 
-# -d    compare against dir names
-# -f    compare against file names
+# compare "hom" against file/dir names and generate matches
 compgen -d -f "hom"
+

Example

+

Skeleton to copy/paste for writing simple completions.

+

Assume a program foo with the following interface:

+
foo -c green|red|blue -s low|high -f <file> -h
+
+

The completion handler could be implemented as follows:

+
function _foo() {
+    local curr=$2
+    local prev=$3
+
+    local opts="-c -s -f -h"
+    case $prev in
+        -c) COMPREPLY=( $(compgen -W "green red blue" -- $curr) );;
+        -s) COMPREPLY=( $(compgen -W "low high" -- $curr) );;
+        -f) COMPREPLY=( $(compgen -f -- $curr) );;
+        *)  COMPREPLY=( $(compgen -W "$opts" -- $curr) );;
+    esac
+}
+
+complete -F _foo foo
+
+

zsh(1)

+

Keybindings

+

Change input mode:

+
bindkey -v              change to vi keymap
+bindkey -e              change to emacs keymap
+
+

Define key-mappings:

+
bindkey                 list mappings in current keymap
+bindkey in-str cmd      create mapping for `in-str` to `cmd`
+bindkey -r in-str       remove binding for `in-str`
+
+# C-v <key>             dump <key> code, which can be used in `in-str`
+# zle -l                list all functions for keybindings
+# man zshzle(1)         STANDARD WIDGETS: get description of functions
+
+

Completion

+

Installation

+

Completion functions are provided via files and need to be placed in a location +covered by $fpath. By convention the completion files are names as _<CMD>.

+

A completion skeleton for the command foo, stored in _foo

+
#compdef _foo foo
+
+function _foo() {
+	...
+}
+
+

Alternatively one can install a completion function explicitly by calling compdef <FUNC> <CMD>.

+

Completion Variables

+

Following variables are available in Completion functions:

+
$words              # array with command line in words
+$#words             # number words
+$CURRENT            # index into $words for cursor position
+$words[CURRENT-1]   # previous word (relative to cursor position)
+
+

Completion Functions

+ +

Completion with _describe

+
_describe MSG COMP
+
+ +
function _foo() {
+    local -a opts
+    opts=('bla:desc for bla' 'blu:desc for blu')
+    _describe 'foo-msg' opts
+}
+compdef _foo foo
+
+foo <TAB><TAB>
+ -- foo-msg --
+bla  -- desc for bla
+blu  -- desc for blu
+
+

Completion with _arguments

+
_arguments SPEC [SPEC...]
+
+

where SPEC can have one of the following forms:

+ +

Available actions

+
(op1 op2)   list possible matches
+->VAL       set $state=VAL and continue, `$state` can be checked later in switch case
+FUNC        call func to generate matches
+{STR}       evaluate `STR` to generate matches
+
+

Example

+

Skeleton to copy/paste for writing simple completions.

+

Assume a program foo with the following interface:

+
foo -c green|red|blue -s low|high -f <file> -d <dir> -h
+
+

The completion handler could be implemented as follows in a file called _foo:

+
#compdef _foo foo
+
+function _foo_color() {
+    local colors=()
+    colors+=('green:green color')
+    colors+=('red:red color')
+    colors+=('blue:blue color')
+    _describe "color" colors
+}
+
+function _foo() {
+    _arguments                              \
+        "-c[define color]:color:->s_color"  \
+        "-s[select sound]:color:(low high)" \
+        "-f[select file]:file:_files"       \
+        "-d[select dir]:fir:_files -/"      \
+        "-h[help]"
+
+    case $state in
+        s_color) _foo_color;;
+    esac
+}
+

tmux(1)

Terminology: