Win95 StringReplace 1.20
                ------------------------


ATTENTION:    CHANGE FROM VERSION 1.0 + 1.1 to 1.2
---------     ^f - FF Formfeed does not work anymore!!! 
              (see below: usage, paragraph 5)


 A) INSTALLATION
 B) USAGE
 C) THE REGISTERED VERSION/REGISTRATION


   
   A) INSTALLATION:
   copy sr.exe into any subdir in your PATH.


   B) USAGE:
   Sr.exe can to be used from the DOS commandline 
   or may be invoked via icon from the Win95 desktop directly.


   1)  commandline usage:

   sr [path][targetfile] [path][replace_string_file] [-r]

   targetfile: any ascii file (.txt, .html etc.)
   replace_string_file: see below
   r-switch: replace recursively in dirs below current dir

   2)  replace_string_file structure:

   an ascii file containing any number of
   pairs of strings that are to be replaced
   one pair on each line,
   original string first, replacement string second,
   separated by any number of spaces.
   Strings that consist of more than one separate substring
   must be enclosed in quotes.
   Replacement with "nothing": use "" (empty double quotes).
      

   3) EXAMPLES:

   replace_string_file content-example:

      file://localhost/c:\www_server  http://mydomain.com
      "This is vrong"   "This is right"
      \ /
      ä   &auml

   commandline-example:

   sr *.html strings_to_be_replaced.txt -r

   will replace the string-pairs contained in 
   strings_to_be_replaced.txt in all HTML files in the 
   current dir and all dirs below the current.

   4)  From-within-Win95 usage:

   Establish a shortcut from sr.exe to your desktop.
   If sr is evoked a window will open
   and you will be prompted for the target_file, the 
   replace_string_file and the start-dir.
   A checkbox to select/de-select recursive action within
   all dirs below the start-dir will appear too.

   5)  Replace none-printable characters: (REGISTERED VERSION ONLY)

ATTENTION: CHANGES FROM VERSION 1.0: 
             ^f - FF Formfeed DO NOT USE ANYMORE
             (because the letter "f" is similar to the
             hex-number "f" this feature had to go)


    None-printables can be replaced or added:

    ^r  - CR (0Dh)
    ^n  - LF (0Ah)
    ^t  - TAB (08h)
    ^^  - ^
    ^"  - Quotation marks  "
    ^n  - Newline
    ^r  - Carriage return
    ^t  - Horizontal tab
    ^^  - ^ (Carret)

    (e.g.: ^r^n will replace a carriage-return-newline glueing 
     alle lines together to one long line)

    You can also use the hexadecimal representation of
    e.g. ansi codes (if you know them :-)) 
    So if you know the hex-number of a character you may use:

    ^xx - xx= hex-number, i.e.. 5A or 7f

    
   6)  Starting from the Windows desktop with shortcut:
    
    The shortcut properties window allows for entry of 
    a commandline. Here you may specify target_file,
    replace_string_file and a start-dir. (If you omit one
    or more of the required parameters the 
    startup-window will appear.)
    Optional is only the "r" switch for recursive
    replace-action.
    You can configure multiple shortcuts with different 
    filenames for various repetitive tasks.


   C) THE REGISTERED VERSION/REGISTRATION:

   You are free to evaluate this program for 30 days.
   After this time you are legaly obliged to REGISTER or delete 
   sr.exe from your system.

   The registered version allows you to replace none-printable 
   characters (see list above). 
   You will not receive any disks in the mail but a 5-character 
   activation-code.
   Here is how you activate (and register at the same time) the 
   none-printable-replace function:

   from the DOS commandline run: 
   
            sr -a:X123Y 
   
   if X123Y is your activation-code


   The registration-fee is US$ 15.-

   Register via CompuServe: go swreg  the registration# is 8734
   you will receive a personal activation key via e-mail asap.

   Register by phone/fax/e-mail:
   If you want to pay by check (drawn on a US bank only!), 
   please make it payable to: NorthStar Solutions 
   and mail it to:

      NorthStar Solutions
      PO Box 25262
      Columbia, SC 29224
      USA

   Don't forget your mailing address and mention that you want to 
   register StringReplace for Win95!

   ATTENTION: If you register with your credit-card please note that
   the company name that will appear on your monthly bill of your CC
   company will be NORTHSTAR SOLUTIONS, not me!

   Easiest is registration with our convenient registration-service-lines:
   Calls from inside the US: 1-800-699-6395 (10:00 a.m. - 10 p.m. Eastern Standard Time)
   Calls from outside the US:  803-699-6395 (10:00 a.m. - 10 p.m. Eastern Standard Time)
   Fax from inside or outside the US: 
   803-699-5465  (24 hours available, international and business orders encouraged)
   E-mail: CompuServe 71561,2751  
   InterNet 71561.2751@compuserve.com  
   
   Please note: Absolutely NO information about the program or technical 
   assistance can be given by the 800-operator. They are only processing 
   your registration. 




This program has been developed and tested under Win95 release Aug'95

For update information check http://lightage.com/stringreplace/
bugreports and questions: e-mail to: samvado@mail.hh.provi.de
or CIS 100120,411.