                Win95 StringReplace
                ------------------- 


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


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


   B) USAGE:
   Sr.exe is basically a utility to be used from 
   the DOS commandline although it 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: 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).
   r-switch: replace recursively in dirs below current dir.

   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.

   2)  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.

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

    The following none-printables can be replaced or added:

    ^f  Formfeed
    ^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)
    
   4)  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.


   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 some none-printable 
   characters (see list above). 
   You will not receive any disks in the mail but a 5-character 
   activation-code.
   from the DOS commandline run: 
   
            sr -a:X123Y 
   
   if X123Y is your activation-code to gain those additional features.


   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.
