;
                                     GF.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               4k (27)   DDE8  1.3        Dave Ramsey 5/89         Z3COM4

  1- Syntax  2- Error Messages  3- Examples of Use                            


   GF is a Generalized file Filter program designed to  replace  any character
in a specified input file with any other character on a global basis.  
:1

   Syntax:  GF du:fn1 du:fn2 oldch newch
   
... where   du:fn1     is the input file spec;
            du:fn2     is the output file spec;
            oldchar    is the search character; and
            newchar    is the replacement character.,

   If invoked  with  no  arguments or the  wrong number of arguments,  GF will 
present a help screen to the user.

   ^   -->  convert to a control character (^M is a carriage return).  
   ~   -->  convert to lowercase (~M is an "m").  
   \   -->  signals a hexadecimal string.

   GF will only recognize control characters specified with  a '^' if they are 
from 01h to 1Ah (^A through ^Z).   Other characters should  be  specified with 
the  hex  escape sequence.   'Trigger' characters  (\, ^, ~)  are  replaced by 
repeating them twice on the command line.
:2


Error Messages:


   a. "Input file not found."

   b. "Unable to open specified output file."

   c. "Parsing error!"

   d. "Incorrect number of arguments!"
:3


Examples of Use:

   a.  A0>GF INFILE.TXT OUTFILE.TXT ^J ^M

       - will convert all the linefeeds in INFILE.TXT to  carriage  returns in 
         the file OUTFILE.TXT.   (I've used it often in this  mode to clean up 
         documents  prepared  on Un*x  systems  since  Un*x  uses only  a bare 
         linefeed as a line terminator.)

   b.  A0>GF INFILE.TXT OUTFILE.TXT Z ~z

       - will convert all uppercase Z's to lower case z's.

   c.  A0>GF INFILE.TXT OUTFILE.TXT /7F /0D

       - will convert all ASCII delete characters to carriage returns