* Gsar-1.12 for Windows *
=========================

What is it?
-----------
Gsar: general search and replace utility

Description
-----------
gsar (General Search And Replace) is a utility for searching for and
--- optionally --- replacing strings in both text and binary files.
The search and replace strings can contain all kinds of characters
(0--255), i.e. Ctrl characters and extended ASCII as well.

The algorithm used is a variation of the Boyer-Moore search algorithm,
modified to search binary files. As a result of this, gsar is blindingly
fast.

Opposed to line oriented search programs (like grep(1)), gsar will find
all matches on a line. Actually, gsar doesn't know anything about lines
at all, all files and strings are treated as binary.

Gsar can search one or several files for a string and report the
occurrences. Gsar can read one file, search for a string, replace it with
some other string, and create a new file containing the changes. Gsar can
perform a search and replace in multiple files, overwriting the originals.
Finally, gsar can work as a filter, reading from standard input and
writing to standard output.
	 
Homepage
--------
http://home.online.no/~tjaberg
	 
System
------
- MS-Windows 95 / 98 / ME / NT / 2000 / XP with msvcrt.dll
- if msvcrt.dll is not in your Windows/System folder, get it from
  Microsoft <http://support.microsoft.com/default.aspx?scid=kb;en-us;259403">
  or by installing Internet Explorer 4.0 or higher
  <http://www.microsoft.com/windows/ie>

Notes
-----
- Bugs and questions on this MS-Windows port: gnuwin32@users.sourceforge.net

Package Availability
--------------------
- in: http://gnuwin32.sourceforge.net

Sources
-------
- gsar-1.11-src.zip

Compilation
-----------
The package has been compiled with GNU auto-tools, GNU make, and Mingw
(GCC for MS-Windows). Any differences from the original sources are given
in gsar-1.12-GnuWin32.diffs in gsar-1.12-src.zip. Libraries needed
for compilation can be found at the lines starting with 'LIBS = ' in the
Makefiles. Usually, these are standard libraries provided with Mingw, or
libraries from the package itself; 'gw32c' refers to the libgw32c package,
which provides MS-Windows substitutes or stubs for functions normally found in
Unix. For more information, see: http://gnuwin32.sourceforge.net/compile.html
and http://gnuwin32.sourceforge.net/packages/libgw32c.htm.