home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / misc_utils / scan / scan.doc < prev    next >
Text File  |  1991-03-09  |  2KB  |  57 lines
  1.  
  2. NAME
  3.     Scan - display the character contents of any file
  4.  
  5. AUTHOR  
  6.     Dan Fish (console routine by Jim Cooper)
  7.  
  8. SYNOPSIS
  9.  
  10.     Scan <infile> [outfile] [-s(ort)]
  11.     
  12. ARGUMENTS
  13.     
  14.     <...> denotes required argument(s)
  15.     [...] denotes optional argument(s)
  16.     (...) denotes optional extraneous input
  17.  
  18.     FLAGS 
  19.  
  20.     Currently only one:  -s  (or -sort)
  21.     
  22.     If the -s flag is applied, the output will be sorted in descending
  23.     order of character frequency.  Default output is to display the 
  24.     characters in the ascii sequence of 0-255
  25.  
  26. DESCRIPTION
  27.  
  28.     Displays the individual character count and percentage of total for
  29.     each different character in a file.  Character values are displayed
  30.     in ASCII and Hex along with the actual character (if displayable).
  31.     Non-printable characters (as determined by the isprint() function)
  32.     are highlighted for easy identification.
  33.  
  34.     The listing is displayed on a console window.      To page through the
  35.     listing press the space bar.  To exit,    use <ESC>, <Q> or <CTRL>-C.
  36.     At the bottom of each page a status line shows the current page, the
  37.     total number of characters in the file,    the number of different 
  38.     characters, and the input filename.
  39.  
  40.     Possible uses would be to scan a file for relative character counts
  41.     (I.E. cryptography), scan files for binary characters, scan data or 
  42.     source files for a matching number of (),{},[], scan text files to 
  43.     determine LF/CR configurations, etc...
  44.  
  45.  
  46. BUGS (and other features)
  47.  
  48.  
  49.     Under WB 2.0, expect some strange results if you are using different 
  50.     height fonts for the system default and screen fonts.  The console 
  51.     routines are not quite smart enough to figure these out.
  52.  
  53.     While most uses of the -s(ort) switch will work with a stack as 
  54.     little as 4K, some may require a stack setting of up to about 
  55.     20K.
  56.  
  57.