summary refs log tree commit diff
diff options
context:
space:
mode:
authorPeter Stephenson <p.stephenson@samsung.com>2020-01-11 14:07:19 +0000
committerPeter Stephenson <p.stephenson@samsung.com>2020-01-11 14:07:19 +0000
commit2ce5f6d79a70060c65b2d1ff456e5b505309e0be (patch)
tree6cb823beba806087bef83abcfbb4d7aa4439c948
parent70d6d0d86cffac331bead544581f0b921418ae37 (diff)
downloadzsh-2ce5f6d79a70060c65b2d1ff456e5b505309e0be.tar.gz
zsh-2ce5f6d79a70060c65b2d1ff456e5b505309e0be.tar.xz
zsh-2ce5f6d79a70060c65b2d1ff456e5b505309e0be.zip
users/24628 (fixed): More doc for selectw-word-style widgets.
Add example of how to add a new binding for a widget that fixes
a particular word behaviour using styles.
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/contrib.yo15
2 files changed, 19 insertions, 1 deletions
diff --git a/ChangeLog b/ChangeLog
index dd668e9bd..0b904e482 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2020-01-11  Peter Stephenson  <p.stephenson@samsung.com>
+
+	* users/24628 (fixed up): Doc/Zsh/contrib.yo: Add example of how
+	to bind word matching widget with a fixed style.
+
 2020-01-10  Daniel Shahaf  <danielsh@apache.org>
 
 	* 45266: Completion/Linux/Command/_losetup: Fix losetup
diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index 6a80cd253..c6bf745b7 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -2227,7 +2227,20 @@ is set in the context tt(:zle:*) to tt(true) if the word style is
 tt(bash) and tt(false) otherwise.  It may be overridden by setting it in
 the more specific context tt(:zle:forward-word*).
 
-Here are some examples of use of the styles, actually taken from the
+It is possible to create widgets with specific behaviour by defining
+a new widget implemented by the appropriate generic function, then
+setting a style for the context of the specific widget.  For example,
+the following defines a widget tt(backward-kill-space-word) using
+tt(backward-kill-word-match), the generic widget implementing
+tt(backward-kill-word) behaviour, and ensures that the new widget
+always implements space-delimited behaviour.
+
+example(zle -N backward-kill-space-word backward-kill-word-match
+zstyle :zle:backward-kill-space-word word-style space)
+
+The widget tt(backward-kill-space-word) can now be bound to a key.
+
+Here are some further examples of use of the styles, actually taken from the
 simplified interface in tt(select-word-style):
 
 example(zstyle ':zle:*' word-style standard