HCU.exe (HTML Change Utility)
Version:    3.1.2 (10/10/96) Demo Version. MIV+ miv@xs4all.nl
Created by: Michel Verbraak. http://www.xs4all.nl/~miv

-- This program is free for Non-commercial users (Shareware)  --
-- Please register by sending an e-mail with your:            --
--  1. Name                                                   --
--  2. Address                                                --
--  3. ZIP code                                               --
--  4. Country.                                               --
--  5. Profession.                                            --
--  6. e-mail address.                                        --

This utility can be used to change,delete or insert (a) string(s) in
multiple HTML/ASCII files.
Is has to run in DOS or a DOSbox under Win3.x,Windows95 or WindowsNT. It will
leave the long-filenames used in Windows95 or WindowsNT intact. When you
specifie a filename please use the 8.3 standard which can still be used
in Windows95 and WindowsNT.

HOW to INSTALL
==============

The zip file has been created by using PKZIP v2.04g. This or a higher
version can be used to unzip the file into it's sepparate components.

When you read this you have been able to unzip the complete program.
It should consist of the following two files:

hcu.exe    14.944 bytes
hcu.txt     4.613 bytes

Place the file hcu.exe into a directory which is a part of your
PATH environment variable. Or place the directory which contains
hcu.exe into your PATH environment variable.

1) To check your PATH environment:

input:
c:>PATH
output:
PATH=C:\WINDOWS;C:\DOS
When your output looks a bit like this put it for example in to c:\dos.

2) To add it to your PATH.

Edit your AUTOEXEC.BAT by inserting the following line after
the line containing PATH= statement:

PATH=%PATH%;C:\<dirname>
Where <dirname> is the path to the directory containing HCU.exe.

HOW to USE.
===========

Usage:  hcu [-d] [-p] path\filename 'OldString' '[NewString]'
           Or
        hcu [-d] [-p] path\filename 'OldString' [path\Changefilename]

Options:
    -d                   Files in subdirectories should be changed to.    -p                   Prompt before changing strings.
    path\filename        Specifies wich file(s) to change.
    OldString            String to be replaced in the file(s).
    NewString            Replaces the OldString in the whole file.
                         When left out the OldString will be deleted.
    path\Changefilename  The name of the file containing the data to
                         replace the OldString.

When the following strings appear in the OldString or NewString they
can be changed into the character mentioned after the string.
        123    -->      < (Smaller than sign)
        890    -->      > (Larger than sign)
        456    -->      = (Equal sign)

Example 1:
----------

    c:>hcu -d c:\www\*.htm 'Room 110' 'Room 120'

Replaces in all the files ending with .htm, in the directory c:\www, the
string Room 110 into  Room 120. Also the files *.htm in the subdirectories.
Without prompting.

Example 2:
----------

    c:>hcu -d -p c:\www\*.htm 'Room 110' 'Room 120'

Replaces in all the files ending with .htm, in the directory c:\www, the
string Room 110 into  Room 120. Before the change it will prompt you if
the change should really occur. It also changes and prompt for all the
*.htm files in the subdirectories.

Example 3:
----------

    c:>hcu -d -p c:\www\index*.htm '123BODY890' '123BODY Background456backgr.gif890'

The utility will first ask you if the 123 in the Old- and Newstring should
be replaced into <. The 456 into =. And the 890 into >. After answered on
all the questions with Y. Then all the files index*.htm the string <BODY>
will be changed into <BODY Background=backgr.gif> when you answered Y on
the prompts(-p).
It also changes and prompt for all the *.htm files in the subdirectories.

Example 4:
----------

    c:\hcu index*.htm '123BODY890' new.txt

The utility will first ask you if the 123 in the Old- and Newstring should
be replaced into <. And the 890 into >.After answered all the questions
with Y. The string <BODY> is replaced by the characters which are in the
file new.txt. Only the files index*.htm will be changed. No files in the
subdirectories.
The program will also not prompt before making a change.

When you do find problems with this utility please let me know.

Greets,
Michel Verbraak.

mailto: miv@xs4all.nl
http://www.xs4all.nl/~miv
