about summary refs log tree commit diff
diff options
context:
space:
mode:
authorDaniel Shahaf <d.s@daniel.shahaf.name>2016-10-27 12:59:07 +0000
committerDaniel Shahaf <d.s@daniel.shahaf.name>2016-10-28 16:02:03 +0000
commit3881c6b9a4b5bb7863090c2650ce404def657886 (patch)
tree8409434b4827f631817dcd8c6605aedd94da55d5
parent5dbfbd8bd016832c46c63b095cb60d043b37d379 (diff)
downloadzsh-3881c6b9a4b5bb7863090c2650ce404def657886.tar.gz
zsh-3881c6b9a4b5bb7863090c2650ce404def657886.tar.xz
zsh-3881c6b9a4b5bb7863090c2650ce404def657886.zip
users/22036: bracketed-paste: Document cutbuffer behaviour; clarify.
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/zle.yo9
2 files changed, 11 insertions, 3 deletions
diff --git a/ChangeLog b/ChangeLog
index 5caf8735f..45ab87de5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2016-10-28  Daniel Shahaf  <d.s@daniel.shahaf.name>
+
+	* users/22036: Doc/Zsh/zle.yo: bracketed-paste: Document
+	cutbuffer behaviour; clarify.
+
 2016-10-27  Daniel Shahaf  <d.s@daniel.shahaf.name>
 
 	* unposted: Doc/Zsh/compsys.yo, Doc/Zsh/contrib.yo: Minor
diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index 0102cb0e6..64bfcc2d3 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -2175,10 +2175,13 @@ item(tt(bracketed-paste))(
 This widget is invoked when text is pasted to the terminal emulator. It
 is not intended to be bound to actual keys but instead to the special
 sequence generated by the terminal emulator when text is pasted.
+The pasted text is inserted to the buffer and placed in the cutbuffer.
 If a numeric argument is given, shell quoting will be applied to the
-pasted text before it is inserted. When called from a widget function,
-an argument can be given to specify a variable to which pasted text is
-assigned.
+pasted text before it is inserted.
+
+When called from a widget function as `tt(bracketed-paste) var(name)`, the
+pasted text is assigned to the variable var(name) and no other processing is
+done.
 
 See also the tt(zle_bracketed_paste) parameter.
 )