39039: fix documentation of transpose-words

2 files changed, 12 insertions, 5 deletions

diff --git a/ChangeLog b/ChangeLog
index 8612c1c18..fbf93064a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2016-08-15  Peter Stephenson  <p.stephenson@samsung.com>
+
+	* 39039: Doc/Zsh/zle.yo: fix documentation for transpose-words.
+
 2016-08-13  Oliver Kiddle  <opk@zsh.org>
 
 	* 39036: Completion/Unix/Command/_git: update up to git 2.9.2
diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index fad5e15fa..0102cb0e6 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -1949,11 +1949,14 @@ tindex(transpose-words)
 item(tt(transpose-words) (tt(ESC-T ESC-t)) (unbound) (unbound))(
 Exchange the current word with the one before it.
 
-With a positive numeric argument em(N), the word before the cursor is
-transposed with the following em(N) words.
-
-With a negative numeric argument em(-N), the word after the cursor
-is transposed with the preceding em(N) words.
+With a positive numeric argument em(N), the word around the cursor, or
+following it if the cursor is between words, is transposed with the
+preceding em(N) words.  The cursor is put at the end of the resulting
+group of words.
+
+With a negative numeric argument em(-N), the effect is the same as using
+a positive argument em(N) except that the original cursor position is
+retained, regardless of how the words are rearranged.
 )
 tindex(vi-unindent)
 item(tt(vi-unindent) (unbound) (tt(<)) (unbound))(