;
                                     GF.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               3k (20)   0587  1.0        Dave Ramsey 2/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.

   A ^ character before either oldchar or newchar tells GF to convert it  to a
control character.  A ~ character before either oldchar or newchar tells GF to
convert it to lowercase (i.e., ^M is a carriage return and ~M is an "m").
: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.
