home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / kline100.zip / KLINE.DOC < prev    next >
Text File  |  1994-08-28  |  3KB  |  79 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                 KLine v1.00
  7.          DOS utility: Kills lines which contain a specified string
  8.                   Freeware, copyright (c) 1994 [94/08/28]
  9.                                      by
  10.                            David Daniel Anderson
  11.                                  Reign Ware
  12.  
  13.                ** READ REIGNWAR.TXT FOR LEGAL MUMBO JUMBO **
  14.  
  15.  
  16.  
  17.  
  18. KLine kills all lines in a text file which contain a user-specified string.
  19. All other lines are left intact.  Original file is renamed to filename.BAK.
  20.  
  21. Usage:  KLine text_file(s) "offending string" [/c (case sensitive)]
  22. ------
  23.  
  24. Examples:
  25. ---------
  26.  
  27.   KLine caller.log "conference joined"
  28.   KLine d:\pcboard\*.log "Downloaded file:" /c
  29.   KLine *.* "darn "
  30.  
  31. Notes (if curious or confused):
  32. -------------------------------
  33.  
  34. *) You can not provide multiple file specifications during the same run,
  35.    such as:
  36.  
  37.      KLine *.log *.rec d:\pcboard\*.upl *.usr "pgp"
  38.  
  39.    You will have to run KLine 4 times to accomplish the above.
  40.  
  41. *) KLine will make a backup of each file processed.  The backup will have
  42.    the same name, but an extension of .BAK.  Therefore, you can not kill
  43.    lines from a .BAK file (KLine would be unable to create a .BAK file).
  44.  
  45. *) Since KLine always creates a .BAK file, there may be naming conflicts
  46.    which prevent a file from being processed.  If you have two files with
  47.    different extensions, but the same name, only the first will be processed
  48.    when an ambiguous wildcard specification expands to both.
  49.  
  50.    For example, you have TUESDAY.REC and TUESDAY.LOG in your directory.
  51.    You then run:
  52.  
  53.      KLine TUESDAY.* "bulletin"
  54.  
  55.    In this case, only the first TUESDAY.* file would be processed, since
  56.    KLine would be unable to create a unique .BAK file for -both- files.
  57.  
  58. *) The "offending string" MUST be enclosed in quotes!  Currently there is
  59.    no way to specify a quote character (") as part of the string itself.
  60.    I doubt this ability will be added in a later version either - sorry.
  61.  
  62. *) KLine defaults to ignoring case when comparing strings.  In other words,
  63.    "username" and "USERNAME" and "uSeRnAmE" are all considered the same.
  64.    If you want to kill "username" lines, but preserve "Username" lines,
  65.    then specify '/c' as the final parameter (see second example above).
  66.  
  67. *) If KLine is unable to complete its task successfully for any reason, an
  68.    error message will be issued, and the DOS errorlevel will be set to the
  69.    number displayed.  KLine sets the errorlevel to 0 for success, or any
  70.    other number for failure.  (See KLine.PAS for detectable errors.)
  71.  
  72. *) If KLine does abort prematurely, the original file will most likely still
  73.    have the original name and extension.  But the .BAK file will most likely
  74.    be corrupt.  In any case, you should examine BOTH of them to make sure!
  75.  
  76.  
  77.                ** READ REIGNWAR.TXT FOR LEGAL MUMBO JUMBO **
  78.  
  79.