*swapstrings.txt*	The swapstringsment Tool			Jan 21, 2009

Author:  Charles E. Campbell  <NcampObell@SdrPchip.AorgM-NOSPAM>
	  (remove NOSPAM from Campbell's email first)
Copyright: (c) 2004-2006 by Charles E. Campbell		*swapstrings-copyright*
           The VIM LICENSE applies to swapstrings.vim and swapstrings.txt
           (see |copyright|) except use "swapstrings" instead of "Vim"
	   No warranty, express or implied.  Use At-Your-Own-Risk.

==============================================================================
1. Contents				*swapstrings* *swapstrings-contents*

	1. Contents.................................: |swapstrings-contents|
	2. Swapstrings Manual.......................: |swapstrings-manual|
	3. Swapstrings History......................: |swapstrings-history|

==============================================================================
2. Swapstrings Manual					*swapstrings-manual*

>
	:[range]SwapStrings[!] string1 string2
<
    Default range is % (ie. 1,$ == entire file)

    If ! is not present, then both strings are protected with \<...\> before
    swapping.  Otherwise, the strings will be swapped even if they appear as
    part of other words.

The SwapStrings command allows one to swap two strings in a range of lines.
As an example: >

	:SwapStrings! abc def
<
will change all "abc" strings to "def" strings and vice versa.  The program
works by searching the range of lines for non-use of a control character,
beginning with ctrl-a.  The first control character not found in the range
of lines is used to facilitate the swap:

	substitute string1                    -> selected control character
	substitute string2                    -> string1
	substitute selected control character -> string1


==============================================================================
3. Swapstrings History					*swapstrings-history*
   v1  Dec 19, 2006  * initial release of swapstrings

==============================================================================
Modelines: {{{1
vim:tw=78:ts=8:ft=help:fdm=marker: