home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help09.lbr / GF.HZP / GF.HLP
Encoding:
Text File  |  1993-06-12  |  1.8 KB  |  56 lines

  1. ;
  2.                                      GF.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                3k (20)   0587  1.0        Dave Ramsey 2/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.  
  15.    Syntax:  GF du:fn1 du:fn2 oldch newch
  16.    
  17. ... where   du:fn1     is the input file spec;
  18.             du:fn2     is the output file spec;
  19.             oldchar    is the search character; and
  20.             newchar    is the replacement character.,
  21.  
  22.    If invoked  with  no  arguments or the  wrong number of arguments,  GF will 
  23. present a help screen to the user.
  24.  
  25.    A ^ character before either oldchar or newchar tells GF to convert it  to a
  26. control character.  A ~ character before either oldchar or newchar tells GF to
  27. convert it to lowercase (i.e., ^M is a carriage return and ~M is an "m").
  28. :2
  29.  
  30.  
  31. Error Messages:
  32.  
  33.  
  34.    a. "Input file not found."
  35.  
  36.    b. "Unable to open specified output file."
  37.  
  38.    c. "Parsing error!"
  39.  
  40.    d. "Incorrect number of arguments!"
  41. :3
  42.  
  43.  
  44. Examples of Use:
  45.  
  46.    a.  A0>GF INFILE.TXT OUTFILE.TXT ^J ^M
  47.  
  48.        - will convert all the linefeeds in INFILE.TXT to  carriage  returns in 
  49.          the file OUTFILE.TXT.   (I've used it often in this  mode to clean up 
  50.          documents  prepared  on Un*x  systems  since  Un*x  uses only  a bare 
  51.          linefeed as a line terminator.)
  52.  
  53.    b.  A0>GF INFILE.TXT OUTFILE.TXT Z ~z
  54.  
  55.        - will convert all uppercase Z's to lower case z's.
  56.