
Thank you for trying out the Witzend ReplaceInFiles Add-in (tm) evaluation 
version, created by Witzend Software. 

The component was given its name because it adds a "Replace in Files" command 
to the Visual C++ environment's Edit menu. Once installed, the ReplaceInFiles 
Add-in lets you search and replace in all project source files, all in a 
single step.

The ReplaceInFiles Add-in works with Visual C++ 5.0 and higher. The time-
trial version you have downloaded works for 30 days after installation. It's 
a full-featured copy of the original, giving you plenty of opportunities to 
try out the ReplaceInFiles Add-in in your own projects. Please feel free to 
pass on the Setup5 program to any of your colleagues and friends who also use 
Visual C++.

(If you are unsure about which version of Visual C++ you have, go ahead and 
run the Setup5 program anyway. It will tell you whether or not your version 
accepts add-ins.)



What is an Add-in?
------------------

An add-in is a COM-based dynamic link library that can merge seamlessly into 
a host program like Developer Studio. (Developer Studio is the name of the 
Visual C++ environment.) The whole concept of add-ins is quite ingenious. Add-
ins ensure that Developer Studio is always up-to-date and has the latest 
features -- even features that Microsoft never thought of!

When Developer Studio starts, it loads all registered add-in libraries and 
adds their commands to its own command set. In this way, "Replace in Files" 
appears to be just another DevStudio command, even though the command did not 
exist in the original product. When you click the new "Replace in Files" 
command -- say, on the Edit menu or a toolbar -- DevStudio passes control on 
to the add-in component. The ReplaceInFiles Add-in displays a dialog that 
queries for search parameters such as case-sensitivity, whole-word searching, 
date and time filtering, and so forth. Behind the scenes, the Add-in 
communicates with the Visual C++ environment via COM interfaces.



Installing
----------

Run the Setup5.exe program to install the ReplaceInFiles Add-in. The program 
locates Visual Studio on your system and suggests placing the add-in files in 
the Common\MsDev\Addins folder. We recommend you accept the suggestion, 
because Visual C++ by default looks for add-ins in that folder. 

We also recommend you browse through the Readme file that the Setup5 program 
offers to open. The Readme is an HTML file that contains interesting 
information about the ReplaceInFiles Add-in and describes clearly how to 
complete the installation process.



Uninstalling
------------

The Readme HTML file also explains how to un-install the ReplaceInFiles add-
in when the evaluation period has expired.



About the ReplaceInFiles Add-in
-------------------------------

It used to be that simply revising the name of a variable or function 
throughout a Visual C++ project was time-consuming and prone to errors. You 
were forced to search for all affected files, open each document one by one, 
and execute the environment's Replace command. The Witzend ReplaceInFiles Add-
in changes all that, allowing you to search-and-replace in a single step 
through hundreds of source files.

Click the new "Replace in Files" command to activate the ReplaceInFiles Add-
in. The Add-in queries for search parameters including the "search string" 
and the "replacement string". As their names imply, the search string is the 
word or phrase you want to locate, and the replacement string is the word or 
phrase that replaces the search string.

You can browse for a folder where you want the search to begin. The 
ReplaceInFiles Add-in can of course "drill down" through nested subfolders, 
ensuring that no replacements are missed. The Add-in optionally backs up all 
revised files, so that you can always undo a replacement. When the search-and-
replace operation is complete, you can browse through a list of all revised 
files and open them in the Developer Studio text editor.

The speed of the component may surprise you. All core search functions are 
written in highly-optimized 32-bit assembly language, ensuring maximum speed 
and minimum size. A hundred replacements in a dozen files, for example, takes 
about a second on a mid-range Pentium machine.



Price
-----

License fee for the ReplaceInFiles Add-in is only $49.95, with substantial 
reductions for multiple installations. The license fee includes a 30-day 
warranty and free technical support.



Contact Us
----------


   Witzend Software

   phone:     (206) 439-9371
   email:     info1@witzendsoft.com
   Web site:  http://witzendsoft.com

