I believe the docs are referring to a situation where you add a node at the time you trigger a failover, followed by a subsequent rebalance. While it may not be considered a swap rebalance, it's similar in that data movement is minimized.
Consdider nodes in a cluster:
A B C
If I want to remove B and add D, I can do it in a "swap rebalance":
pre-rebalance: A B C
post-rebalance: A D C
(all vbuckets on B move to D)
This would be done by adding D and removing B before starting the rebalance.
Hope that helps,
Matt
--
Matt Ingenthron
Couchbase, Inc.