;
                                  CNTLH.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               3k (22)   C91B  1.1        Dave McCord 9/89         Z3COM8

  1- Syntax/Options  2- Notes                                                 

   CNTLH is a text filtering program for captured telecomm conversation files.
It cleans up such "chat" files by:

   1. resetting the high-order bit of all characters in the input file, making
it also useful to change a WS document-format file to plain ASCII (non-doc).

   2. Filtering out  any control-h (backspace) characters and processing these 
implied edits (deleting the immediately-previous character also).

   3. adding linefeed characters as needed to "orphan" carriage returns.
:1
    Syntax   a0:command>CNTLH <filename>

             a0:command>CNTLH //           <-- help screen

<filename> is  any  unambiguous  zsystem  filename,  for example,  SHERRY.003, 
B12:POOKA.TMP,  or  CHAT:LARRY.TLK.   CNTLH  then  reads  through  <filename>,  
processing as it goes,  and when finished creates an output  file of  the same 
name as the  original file.   The original file  is renamed to .BAK.   This is 
identical to how WordStar works.

When invoked  and running,  CNTLH displays  a few  status messages.   Standard 
kinds of errors,  such as being unable to find the input file, will be handled 
and an appropriate message displayed.   In its distributed form,  CNTLH uses a 
little over 35K of TPA;  this can be reduced,  but only  by  reassembling  the 
program with different buffer size selections in the source code.

CNTLH can by aborted during operation at  any time  by pressing  any key.   If 
aborted prior  to completion,  the original file  will be  present  under it's 
original name, unmodified.   There may be a file with a .$$$ extension present 
which should be deleted.
:2

 CNTLH notes 

   a. CNTLH, like any self-respecting  zsystem program,  relies  on SYSLIB and 
      Z3LIB subroutines heavily.   Thus,  you'll need SYSLIB.REL and Z3LIB.REL 
      to reassemble it.   You might want to reassemble it to reduce or enlarge 
      its TPA use or to enhance it.

   b. CNTLH uses sequential file structures and a "pipe" construct.   The pipe 
      is  a FIFO (first-in-first-out) buffer wherein as many characters as the
      pipe is long can be "backed up".   The length of the pipe as distributed
      is 64,  which seems to be a good tradeoff of speed versus maximum number 
      of controlh's handled.  

   c. Vs 1.1 updates
      - adds proper  handling  for  an  existing .BAK  file and  processing of
        orphan cr's (adds lf's) 