home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / misc / tinytools.lzh / FILTEX / FILTEX.MAN < prev    next >
Encoding:
Text File  |  1990-10-10  |  1.7 KB  |  49 lines
  1.  
  2. NAME
  3.     FilTex - Filter text
  4.  
  5.  
  6. SYNOPSIS
  7.     FilTex <File | STDIN> [THRESH #] [NOLF] [NULT]
  8.  
  9.  
  10. REQUIREMENTS
  11.     The ARP library
  12.  
  13.  
  14. DESCRIPTION
  15.     FilTex reads a file, removes all non-text characters, and writes
  16.     the result to the standard output.  The found chunks of text are
  17.     terminated with linefeeds if they weren't already.
  18.     FilTex recognizes most normal ASCII codes + TAB & LF as being text.
  19.     The optional THRESH keyword may be followed by a number indicating
  20.     the minimum number of subsequent text bytes required for FilTex to
  21.     recognize a chunk of bytes as being text.  The default is 4.
  22.     If you do not want the terminating linefeeds, specify the NOLF
  23.     switch.
  24.     The NULT option causes FilTex to pass only null-terminated strings.
  25.     This option reduces the percentage of bogus strings FilTex finds.
  26.     Still, not all text strings in a program file are guaranteed to be
  27.     null-terminated.
  28.  
  29.  
  30. EXAMPLES
  31.     prompt> FilTex >Clues Adventure
  32.     Find pieces of text in a program file.
  33.  
  34.  
  35. BUGS/LIMITATIONS
  36.     -FilTex does not recognize "@", "`", the extended ASCII values
  37.      and most control codes as being text.  This improves the
  38.      filter's selectivity.  If you need umlauts or whatever,
  39.      look at the source and reassemble, or use a file-zapper and
  40.      search for the string 'TextTab:'.  This string is followed
  41.      directly by an array of 256 bytes, the Nth byte corresponding
  42.      to the Nth ASCII code.  If the byte is nonzero, its location
  43.      index will be recognized as a text value.  For zapping clarity,
  44.      I've given each text location its (nonzero) ASCII value.
  45.     -FilTex is only a very simple filter. It therefore passes through
  46.      a lot of garbage text strings if you're filtering binary code.
  47.      The NULT option improves the performance only slightly because
  48.      your average binary code contains a lot of nulls.
  49.