Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm
Precedence: bulk
X-No-Archive: yes
List-Id: Zsh Workers List <zsh-workers.zsh.org>
List-Post: <mailto:zsh-workers@zsh.org>
List-Help: <mailto:zsh-workers-help@zsh.org>
X-Qmail-Scanner-Diagnostics: from mailout3.w1.samsung.com by f.primenet.com.au (envelope-from <p.stephenson@samsung.com>, uid 7791) with qmail-scanner-2.11 
 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1.  
 Clear:RC:0(210.118.77.13):SA:0(-0.5/5.0):. 
 Processed in 0.132513 secs); 15 Aug 2016 09:01:25 -0000
X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au
X-Spam-Level: 
X-Spam-Status: No, score=-0.5 required=5.0 tests=RP_MATCHES_RCVD
	autolearn=unavailable autolearn_force=no version=3.4.1
X-Envelope-From: p.stephenson@samsung.com
X-Qmail-Scanner-Mime-Attachments: |
X-Qmail-Scanner-Zip-Files: |
Received-SPF: none (ns1.primenet.com.au: domain at samsung.com does not designate permitted sender hosts)
X-AuditID: cbfec7f5-f792a6d000001302-da-57b184de37e3
Date: Mon, 15 Aug 2016 10:01:15 +0100
From: Peter Stephenson <p.stephenson@samsung.com>
To: zsh-workers@zsh.org
Subject: Re: [PATCH] enable number argument for transpose-words
Message-id: <20160815100115.25ef4115@pwslap01u.europe.root.pri>
In-reply-to: <20160815093947.3e591f1d@pwslap01u.europe.root.pri>
References: <20160801103212.GA24067@localhost.localdomain>
 <20160812025402.GA5319@localhost.localdomain>
 <20160812102918.5ad0f649@pwslap01u.europe.root.pri>
 <20160815022250.GA3748@localhost.localdomain>
 <20160815093947.3e591f1d@pwslap01u.europe.root.pri>
Organization: Samsung Cambridge Solution Centre
X-Mailer: Claws Mail 3.7.9 (GTK+ 2.22.0; i386-redhat-linux-gnu)
MIME-version: 1.0
Content-type: text/plain; charset=US-ASCII
Content-transfer-encoding: 7bit
X-Brightmail-Tracker:
 H4sIAAAAAAAAA+NgFrrILMWRmVeSWpSXmKPExsVy+t/xq7r3WjaGGzw6aW1xsPkhkwOjx6qD
	H5gCGKO4bFJSczLLUov07RK4MmbuvsBWMJ2jovHhG8YGxqdsXYycHBICJhKz555ih7DFJC7c
	Ww8U5+IQEljKKLHj4FEoZwaTxNed3xghnHOMEq8WNrGCtAgJnGWU+P/bF8RmEVCV2LR1MguI
	zSZgKDF102xGEFtEQFzi7NrzYHFhAXuJrY/fgPXyAtnv73wGq+EUcJDYP+cz1LY2JokH2w6A
	3ccvoC9x9e8nJoj77CVmXjnDCNEsKPFj8j2wocwCWhKbt0EcxCwgL7F5zVtmiOPUJW7c3c0+
	gVF4FpKWWUhaZiFpWcDIvIpRNLU0uaA4KT3XSK84Mbe4NC9dLzk/dxMjJKC/7mBceszqEKMA
	B6MSD69A3YZwIdbEsuLK3EOMEhzMSiK8NsB4EOJNSaysSi3Kjy8qzUktPsQozcGiJM47c9f7
	ECGB9MSS1OzU1ILUIpgsEwenVANj18IpnvpLb/r9Nw8/u1XjgaXC1/OZ/57Ocrsme0o8ZZ+j
	4lqTk7/4rnDmMy/sKzv37u/meVczdb6dMjh+qeqxepOcu3FFfuiC29UTtu+4e1apVXxCteRG
	5gfJuU8q52vkb1dw7VwbnxFqc7Pkvelh669X2s8dmFsdvlXwyOee+dO2m76ZtUriuxJLcUai
	oRZzUXEiAKU/qYVkAgAA
X-Seq: zsh-workers 39039

diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index fad5e15..0102cb0 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))(

