home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / ZSUS / Z3HELP-2.LBR / G.LBR / GF.HZP / GF.HLP
Text File  |  2000-06-30  |  2KB  |  63 lines
  1. ;
  2.                                      GF.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (27)   DDE8  1.3        Dave Ramsey 5/89         Z3COM4
  6.  
  7.   1- Syntax  2- Error Messages  3- Examples of Use                            
  8.  
  9.  
  10.    GF is a Generalized file Filter program designed to  replace  any character
  11. in a specified input file with any other character on a global basis.  
  12. :1
  13.  
  14.    Syntax:  GF du:fn1 du:fn2 oldch newch
  15.    
  16. ... where   du:fn1     is the input file spec;
  17.             du:fn2     is the output file spec;
  18.             oldchar    is the search character; and
  19.             newchar    is the replacement character.,
  20.  
  21.    If invoked  with  no  arguments or the  wrong number of arguments,  GF will 
  22. present a help screen to the user.
  23.  
  24.    ^   -->  convert to a control character (^M is a carriage return).  
  25.    ~   -->  convert to lowercase (~M is an "m").  
  26.    \   -->  signals a hexadecimal string.
  27.  
  28.    GF will only recognize control characters specified with  a '^' if they are 
  29. from 01h to 1Ah (^A through ^Z).   Other characters should  be  specified with 
  30. the  hex  escape sequence.   'Trigger' characters  (\, ^, ~)  are  replaced by 
  31. repeating them twice on the command line.
  32. :2
  33.  
  34.  
  35. Error Messages:
  36.  
  37.  
  38.    a. "Input file not found."
  39.  
  40.    b. "Unable to open specified output file."
  41.  
  42.    c. "Parsing error!"
  43.  
  44.    d. "Incorrect number of arguments!"
  45. :3
  46.  
  47.  
  48. Examples of Use:
  49.  
  50.    a.  A0>GF INFILE.TXT OUTFILE.TXT ^J ^M
  51.  
  52.        - will convert all the linefeeds in INFILE.TXT to  carriage  returns in 
  53.          the file OUTFILE.TXT.   (I've used it often in this  mode to clean up 
  54.          documents  prepared  on Un*x  systems  since  Un*x  uses only  a bare 
  55.          linefeed as a line terminator.)
  56.  
  57.    b.  A0>GF INFILE.TXT OUTFILE.TXT Z ~z
  58.  
  59.        - will convert all uppercase Z's to lower case z's.
  60.  
  61.    c.  A0>GF INFILE.TXT OUTFILE.TXT /7F /0D
  62.  
  63.        - will convert all ASCII delete characters to carriage returns