DOCUMENTATION for KGB.ARC

This  program  is designed to help you  quickly  ferret  out 
files that are no longer needed and purge them from the face 
of  the earth.   After you execute the program and seen  the 
cover sheet you will be asked to select a candidate file for 
extinction.   When you do you will get a display showing the 
first  15 lines or so of the text,  the file size,  and  the 
date of the most recent update.  


There  are  two special cases for the  text  printing.   All 
files  will have all the control characters  removed  except 
the  carriage  return and the line feed.  They will  not  be 
shown on the screen (even as a space) but the count of  such 
characters will be shown.   The purpose is to eliminate  the 
maddening  effects one gets on the monitor when you  try  to 
print a program file,  accessory file,... etc. These strange 
effects  are  caused by characters such as  horizontal  tab, 
vertical  tab,   form  feed,  bel,  ....  .   All  of  these 
characters are removed so if there is any recognizable  text 
it  can  be displayed and read.   A text  file  should  have 
_about_ 30 control characters for 15 lines of text. Fifteen
carriage returns and 15 line feeds.  Most programs will have 
hundreds of control characters in a sample this size.


The  second  special  case applies to files  with  the  file 
extender  .DOC.   These  are taken to be 1st  Word  or  Word 
Writer  files  which  are stored  without  a  space  between 
characters.   KGB  replaces  these control  characters  with 
space  characters so you can read the text.   Note that  this 
isn't  done  for .BAK files because .BAK is  used  in  other 
situations,  for example,  back up files created by Personal 
Pascal.


If  you  can't identify the file from this  sample  you  can 
'type'  (IBM  lingo)  all of the file up  to  32,256  bytes.  
Simply  respond with a 't' to type.   If you want to  delete 
the  file just viewed,  type 'delete' followed by  'Return'.  
You  won't  get a second chance.   I don't believe  that  ST 
users  are a bunch of drooling idiots who need to be  'asked 
three times if what I say is true'.  Any other response will 
take you back to the file selector.   You can either  select 
Cancel to return to the desktop,  or select another file  to 
look at.  In 'type' mode, control characters are sent to the 
monitor so it will go ape just like any other text editor or 
word processor.    

This  is a program that is speeded up quite a bit  by  Turbo 
ST,  especially if you scroll through a large amount of  the 
file.   I'm not hustling for Turbo,  but it is, rough guess, 
about 3 times as fast when showing raw text.   You will  get 
the fastest operation if you use two hands;  keep the  right 
hand on the mouse so the arrow stays pointing at the current 
file and use the left hand to select the file (as opposed to 
choosing the file) and respond to the program.