Copyright ©1997 by Dick Whiting                      
                                                                                
                                                                                
  Standard Disclaimer: I wrote it, it works for me, I don't guarantee           
  that it will do anything productive for anyone else, etc. etc. ;-)            
                                                                                
  HOWEVER, if you do find a use for it: I homeschool my kids and they would     
  love a postcard from where EVER you live. Instant Geography Lesson;)          
                                                                                
  Postcards:    Dick Whiting                                                    
                28590 S. Beavercreek Rd.                                        
                Mulino, Oregon 97042                                            
                USA                                                             
                                                                                
  Email:        Dick Whiting <dwhiting@europa.com>                                                                                 
  HomePage:     http://www.europa.com/~dwhiting/
  IRC:          Satyre on Undernet AmigaCafe                                                                

                                                                                
Basics  
---------

This program takes the output of Serlog and extracts IRC logs from it.
The initial output file includes all lines appearing to be IRC related.
Using THIS file, you can then produce reduced logs for ALL channels and
CHAT conversations, select specific channels, or select specific chat 
sessions to separate files. The final session files remove all of the mIRC
color codes, remove duplicate lines, replaces ACTION with nickname, and
does some basic text formatting for readability. When selecting a
specific nickname to extract, the program should handle any nick changes 
that occur during the session.

This is a CLI only command so far. The basic template is:

Sircle <SL input output [TEMP outfile] | IRC input> [ALL outfile] 
       {CHAN channel-name outfile} {CHAT chat-nick outfile}
		 [QUIET]

Examples:

Create a file from Serlog input containing ALL IRC related lines:

   Sircle SL t:slin t:slout

Create same file but also create the TEMP file with just the serial I/O
commands removed (can be used to learn about TCP/IP, PPP, etc.)

   Sircle SL t:slin t:slout TEMP t:temp

Create the IRC full file and reduce it for ALL channels & chats:

   Sircle SL t:slin t:slout ALL t:all

Same thing, but also create a file for channel #AmigaCafe:

   Sircle SL t:slin t:slout ALL t:all CHAN #amigacafe t:amigacafe

Now, also extract a file for a chat with Satyre:

   Sircle SL t:slin t:slout ALL t:all CHAN #amigacafe t:amigacafe 
          CHAT satyre t:satyre

After doing an intitial Serlog extract, you can use the IRC keyword to 
extract the specific pieces from that file. This saves repeating the Serlog
processing each time:

Sircle IRC t:slout ALL t:all CHAN #amigacafe t:amigacafe CHAT satyre t:satyre


Please note that you can specify multiple CHAN and/or CHAT sequences on the same 
invocation:

Sircle IRC t:slout CHAT lindy t:lindy CHAT trollman t:troll CHAT saraba t:saraba


QUIET turns of the processing messages. 


Requirements  
---------------

You will need from Aminet:

   serlog16.lha       dev/debug   Debugging device to monitor serial-IO


FILES INCLUDED IN THIS ARCHIVE:

   Sircle.Readme          - this is it, so far.
   Sircle                 - the program:)           


v1.0 Beta:

      This is my first attempt at C programming. It was meant to be mainly
      a learning experience and is not a completely polished program. 

      As a learning experience, it has only been tested with AmIRC connections
      to Undernet. If there are varying formats of messages amongst the 
      different nets, then some lines may not be located or handled correctly.

		Note that it will also probably ONLY work with a PPP connection.

      Feel free to contact me if you locate any conditions of improper 
      handling or have any suggestions/comments.


Dick Whiting
December 9, 1997

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                12160   22536  54.0% -lh5- edd1 Dec  9  1997 sircle/Sircle
[generic]                 1737    4505  38.6% -lh5- f840 Dec  9  1997 sircle/Sircle.Readme
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         2 files   13897   27041  51.4%            Dec 18  1997