Copyright: Search and Replace 98, © Copyright 1997-1999 The Andromeda HTML Workshop, All Rights Reserved


Welcome
Welcome to Search & Replace 98 Version 3.0

Welcome!

This utility was born from the need to have a quick and dirty way of processing multiple files with the least effort and the least interaction possible, yet being able to control what was being replaced and what not.

I originally wrote this utility for a company called ellipse data systems, however, since it was not developed any further, I decided to work on the next version myself, under my own name.

I hope you like this utility, and will find a use for it. Me, and a lot of other users like you out there, have worked hard on this version, so that you can have the best utility possible, for the price of absolutely nothing.

Without further ado, you can select any of the links to take you to the legal stuff, who helped work on this release, and the obligatory copyright notes :)

With Regards

Andromeda

andromeda@htmlworkshop.com

The Andromeda HTML Workshop


Legal Notices, Disclaimers
Legal Notices and Disclaimers

This application is subject to the following disclaimers:

This application is a 32-bit application to make use of long file- and directories names. It has been optimized to run fast and efficient and replace many and small files.

The application has also been optimised to provide fast response throughout the Windows® system, but you are recommended not to run the application on heavily used and utilised machines (sluggish machines).

The Standard Warranties apply. I am NOT liable for ANY damages caused to ANY computer data that might impact and or damage the business. It is good data processing procedure to test this application on on-critical data first and to secure any files that might be impacted on by the application to restore those files with minimal loss of time and business value.

Please take the above disclaimer to heart. I cannot be held responsible. Thank You.


License
License for Search & Replace 98

This product is published as FREEWARE.

This means that the product is available free of charge. Any incidents of paid-for copies of Search & Replace 98 should be reported to the Andromeda HTML Workshop immediately.

Any costs connected to Search & Replace 98 are limited to (but not exclusive):

- Internet Connection charges

- Charges related to access to file archives

- Hardcopy mastering of media (CD, floppydisk)

- Distribution costs (related to previous item) of magazines

The most current copy will be available from:

- The Andromeda HTML Workshop

- TUCOWS

- WinFiles

The above locations are notified immediately of any new versions, to be placed into their archives (if applicable) immediately.


Using Search & Replace 98 (Basic)
Using Search & Replace 98 to replace text in a single file

Scenario:

You have a single file and need to find a piece of text and replace it with another.

Steps:

1. Click the Pick Directory button and select the directory in which your file lives. Click OK.

2. Select the correct filter in the drop-down box. The default is HTML Files.

3. Double-click the appropriate file in the displayed file list. The file is then loaded.

4. When searching for a single word or phrase, select Find single line. If you want to replace several lines, or text which wraps on several lines, select Find multiple lines.

5. Click on the Replace Text option to change to the replace text fields. Follow the same steps as in step 4 to replace text with a single line or with multiple lines of text.

6. Press Start to start the process.

The above steps will then cause Search & Replace 98 to switch to its editor to allow you to see each instance being replaced after you approve or decline the replacement. You can cancel the replacement process by pressing the Cancel button when prompted for a replacement.

You can then either press the Save File button, or double-click another file. By double-clicking another file, your current file is saved, and a backup is placed in the same directory.

To turn off the prompts and do an automatic replacement, change to the Settings and uncheck the Visual Replacement Prompt checkbox. Then continue as normal.

See also:

Using Search & Replace 98 (Directory)

Recursive Directory Replacements (Advanced)


Using Search & Replace 98 (Directory)
Using Search & Replace 98 to replace text in a directory of files

Scenario:

You have a directory full of files, and you want to replace a certain piece of text in all files. What do you do? Double-click every file? No, that takes too much time. Allow Search & Replace 98 to automatically do the work for you.

Steps:

1. Click the Pick Directory button and select the directory in which your file lives. Click OK.

2. Select the correct filter in the drop-down box. The default is HTML Files.

3. Change to the Settings tab. Select the Process all files in directory option. It will automatically deselect the visual replacement option, and will also make directory recursion available.  Switch back to the Search & Replace tab.

4. When searching for a single word or phrase, select Find single line. If you want to replace several lines, or text which wraps on several lines, select Find multiple lines.

5. Click on the Replace Text option to change to the replace text fields. Follow the same steps as in step 4 to replace text with a single line or with multiple lines of text.

6. Press Start to start the process.

The above will let Search & Replace 98 run through the directory and search for and replace every instance of the find text in every file in the directory. A backup of every modified file is placed in the same directory. You can press ESC to cancel the process.

See also:

Using Search & Replace 98 (Basic)

Recursive Directory Replacements (Advanced)


Recursive Directory Replacements (Advanced)
Using Search & Replace 98 to process a directory structure

Scenario:

You have a website with multiple directories, and you need to replace the copyright notice with something else. Previous versions of Search & Replace 98 required you to do the directory replacement over and over. What a shlep. Now, in Version 3.0, use the Recurse Directory Structure option together with the directory function to do every file in one go.

Steps:

1. Click the Pick Directory button and select the directory in which your file lives. Click OK.

2. Select the correct filter in the drop-down box. The default is HTML Files.

3. Change to the Settings tab. Select the Process all files in directory option. It will automatically deselect the visual replacement option.

4. Select Recurse Directory Structure. Select Yes to go ahead.  Switch back to the Search & Replace tab.

5. When searching for a single word or phrase, select Find single line. If you want to replace several lines, or text which wraps on several lines, select Find multiple lines.

6. Click on the Replace Text option to change to the replace text fields. Follow the same steps as in step 4 to replace text with a single line or with multiple lines of text.

7. Press Start to start the process.

The above will let Search & Replace 98 run through the entire directory structure and search for and replace every instance of the find text in every file in each directory in the structure. A backup of every modified file is placed in the same directory. You can press ESC to cancel the process.

See also:

Using Search & Replace 98 (Basic)

Using Search & Replace 98 (Directory)


Directory recursion

Directory recursion is a new feature in Version 3.0. This option allows you to do a replacement operation in a whole directory tree. This feature is extremely valuable when having to change a phrase on a big website for example, or in multiple sets of files living in a directory structure.

See also:

Search & Replace Options


backup
File backup

File backup is a new feature in Version 3.0. Files that were modified by the search and replace action are backed up if you select the Make file backups option in the Settings tab.

This option is enabled by default, and will back up changed files with the following extension series:

.bak, .b00, b01 ...

Also see:

Search & Replace Options


Search & Replace Options
Search & Replace 98 Options

Search & Replace 98 has four search & replace options:

Process all files in directory: This option will allow you to automate Search & Replace98 to a large degree. Selecting this option will allow you to search for and replace text in all files matching your currently selected filter

Visual replacement prompt: This option will turn on or off the visual Yes/No/Cancel box which is displayed when a match is found. Selecting Yes in the box will replace the match, No will skip it, and Cancel will cancel the process alltogether. This option is available only with individual files

Recurse directory structure: This option, in conjunction with the above directory function, allows you to do a massive replacement in files in an entire directory structure. This allows webdesigners and webmasters, developers and people working with a lot of text to efficiently find and replace text in files living in a large directory structure

Make file backups: This option, which is selected by default, makes file backups of all changed files. If you make a mistake, or by accident used the wrong filter, you can revert to previous copies by deleting the modified files, and renaming the backup to its original name.

To save these settings, select the Save system settings on exit option.

See also:

System Options


prompts
Visual Replacement Prompts

Visual prompts are enabled only when working with individual files. This option allows you are approve or decline each replacement. It also allows you to cancel out of the process by pressing the Cancel button when you are prompted for a replacement.

See also:

Search & Replace Options


filter
Filters

Filters allow you to specify a set of files matching a certain criteria. These filters are similar to the standard DOS mask. By selecting certain sets of files, you can avoid corrupting unrelated files.

See also:

Custom Filters


Custom Filters
Using custom filters

With Version 3.0, Search & Replace 98 introduces custom filters.

These filters allow you to define up to 25 filters which you define, in addition to the 7 default filters already included in the utility.

These filters allow you to define a tighter or broader spectrum of files than Search & Replace 98 does. Below are some examples of such custom filters:

Tighter spectrum:

HTML Files starting with "A" -  a*.ht*

Broader spectrum:

Any Internet-related file - *.ht*;*.cgi;*.sht*

As you can see from the above example, you can clump several definitions together, simply by using the semicolon (;) to seperate the different filters. Make sure that there are no spaces between the filter and the semicolon, otherwise you may experience different than expected results.

See also:

Adding filters

Editing filters

Deleting filters

Enabling custom filters


System Options

Search & Replace 98 has three system settings:

Play sounds for confirmation: This option, selected by default, will play a system sound with each prompt. Some people get irritated by that, and this option allows you to switch such prompts off.

Disable confirmation to quit: This option allows you to do a "fast" quit. Press the Quit button and the utility closes without any other prompts, unless you have a file that needs to be saved, or while you are still busy searching and replacing.

Save system settings on exit: This option allows you to save your current options when you close Search & Replace 98. This does not apply to the Custom Filters.

See also:

Search & Replace Options


Adding filters

Adding custom filters is simple:

1. Switch to the Settings tab.

2. Right-click on the custom filter grid. Select Add Filter or press Ctrl+A.

3. Type the description of the filter into the Filter Description box.

4. Type the mask of the filter into the Filter Mask box.

5. Press Save to save the filter, or Cancel to back out.

Only 25 custom filters can be added.

See also:

Custom Filters

Editing filters

Deleting filters

Enabling custom filters


Deleting filters

Deleting filters is simple:

1. Switch to the Settings tab.

2. Select the filter you want to edit.

3. Right-click on it and select Delete Filter or press Ctrl+D.

4. Answer Yes to confirm the deletion.

If you have enabled custom filters, and you deleted the current filter, the filter above the one you deleted will be selected when you switch back to the Search & Replace tab.

See also:

Custom Filters

Adding filters

Editing filters

Enabling custom filters


Editing filters

Editing custom filters is simple:

1. Switch to the Settings tab.

2. Select the filter you want to edit.

3. Right-click on it and select Edit Filter or press Ctrl+E.

4. Edit the description of the filter in the Filter Description box.

5. Edit the mask of the filter in the Filter Mask box.

6. Press Save to save the filter, or Cancel to back out.

See also:

Custom Filters

Adding filters

Deleting filters

Enabling custom filters


Enabling custom filters

To be able to use your custom filters, you can simply check the Include custom filters in filters option in the Settings tab. This will tell Search & Replace 98 to include your custom filters in the filterbox when you switch back to the Search & Replace tab.

To remove the custom filters from the filterbox, simply deselect the above option.

See also:

Custom Filters

Adding filters

Editing filters

Deleting filters


Thank yous
My heartfelt thank you's go to:

Users:

Walter Giesbrecht

Ewoud Dronkert

Sven Hoffmann from Quintessence

Steve Lowder from playtesters.com

Chris Pirillo from LockerGnome

Gary Mulhern from NASA

Linda Bloom (Linda, now you can add your own filters :)

Brian Robbins

Jenny Levine

Dave Young

Antony Cowey

Ray Messinger

Paul Smith

Doug Williams

Stephen Roberts

Global Planet for believing in the coolness of this utility

Brad Plevyak

Andrew Baskett

Bryan MacDonald (those filters are for you)

Paul E. Pennebaker

Mark McGuire

Neil A. Durso

Fredrik Kjoelner

David Friedel

Gabriel Androczky

Ben Grimm

Doug Lueh

Michel Dumontier

Bevan Wang

Richard Tallent

Leif Bjornsson

Laurie Farese (Laurie, thanks to your website I get tons of hits. THANK YOU)

Alain Paris

Tom Crandall

Guhan S. (those file backups are for you)

David P. Schwartz

Rebecca Savage

Charles Snell (well Charles, you can add them now :)

Sander Sanders

Marc Scheuner (Marc, you can add those *.PAS files now)

Dave Stockbridge (I'm working on that case insensitive search)

Flemming Kaplov (sorry, but the counting is still off... working on it though)

Ulrik Løvehjerte

Warwick Bone

Matthew Marr

Ted Assur

Tsu Dho Nimh

William Green

Keith W Burns

Rickard Sjöström

Ronnie M.

Paul Thain

Markus Zapke

Ron Balazs (yep, it is freeware, gratis)

Eric Baenen

Erling Fryde

Download sites and magazines:

Roderik from the FREEWARE PUBLISHING SITE

Marie from Rocket Download

Turgut from Internet Freeware

Ranon from FileDudes

James from 5 Star Internet Shareware

Panicos and Marcus from Internet Works / Future Publishing UK

Lisa from Toy Directory

Graham Pockett from Completely Free Software

Sylvain from Mégagiciel

e-Factory

Darrin from ZDNet

Liz from SoftSeek

Kevin from Moochers

The guys from TUCOWS, NONAGS and WinFiles


Copyrights
Copyright notices:

The following copyrights and trademarks are acknowledged. Any other trademarks not mentioned here are implied to be acknowledged.

Microsoft and Windows are registered trademarks of Microsoft Corporation

Borland is a registered, and Delphi a trademark of Borland.com, a division of Inprise Corporation

Search and Replace 98 is © Copyright 1997-1999, The Andromeda HTML Workshop, All Rights Reserved.

Search & Replace 32-bit is © Copyright 1997, ellipse data systems, All Rights Reserved


mask
Masks

Masks are what makes a filter tick. Since the filter must filter out all unwanted files, the mask tells the filter what is allowed through the filter. Masks can have any valid DOS-style format, as illustrated below:

*.exe

d?d*.ex?

???.dat

*.d?x

*.dat;*.lst;*.cob

See also:

Adding filters

Editing filters

Deleting filters


Contents

Welcome

Using Search & Replace 98:

Using Search & Replace 98 (Basic)

Using Search & Replace 98 (Directory)

Recursive Directory Replacements (Advanced)

Settings:

Search & Replace Options

System Options

Custom Filters

Using Custom Filters:

Adding filters

Editing filters

Deleting filters

Enabling custom filters

Legal Notices, Copyrights, Disclaimers:

Legal Notices, Disclaimers

Copyrights

License

Thank yous

This document is © Copyright 1999, The Andromeda HTML Workshop, All Rights Reserved