---------------------------------------------------
mIRCStats v1.08 - Uploaded 11.2.1999
by Mikko 'Ave' Auvinen (ave@cc.tut.fi)

homepage: http://www.students.tut.fi/~ave/mircstats
     FAQ: http://www.students.tut.fi/~ave/mircstats/mircstatsfaq.html
---------------------------------------------------
HTTP-Component programmed by Francois Piette (http://www.rtfm.be/fpiette).
---------------------------------------------------

mIRCStats is an easy-to-use IRC channel reporting tool, which analyzes channel log-files
produced by the most commonly used IRC-client, mIRC, and creates a nice looking
HTML-page consisting of channel activity statistics, user reports, tables about changed
channel topics and all kinds of miscellaneous information taken from the log file. 


Some guidelines:
----------------
It's easy to start making statistics using mIRCStats: 

	* Make sure you have a mIRC client program (version 5.31 or higher). (download: http://www.mirc.com) 

	* Run mIRC and turn on "timestamps", by checking timestamps-checkbox in the
          channel window's options (or use command /timestamp on). 

 	* Start logging channels you are on by checking "Automatically log channels" 
	  at mIRC Options/Logging. 

	*You can ease your life by doing this in mIRC: 
    	     - Check "Strip control codes" and 
	     - uncheck "Lock log files" at Options/irc/Logging. 

After doing this your mIRC is making .log-files of all channel activities on those channels
you are on. You can generate statistics any time by running mIRCStats and selecting a
proper mirc log file. 


VERSION INFO:
-------------


11.2.1999 - v1.08

	  *** Competition declared! - Make cool configurations in your statistics! mIRCStats
	  is very easy to configure for nice and personal touch. Best looking pages will get
	  a top spot in mIRCStats users link list.

	  hint: Put your own html header code in mircstatsheader.txt - the program will
   	        automatically add it to every stats you run. See v1.06 info for details.
	  	example: <img src="http://your.server/your_own_logo.jpg"> will add a picture 
		         to the top of every page you run! :)
	  ***

	
	- Reporting enhancements: Table colour transformations (one more table sheet)
	  and one entry added to "Big Numbers"-table.

	- Possibility to disable initial countdown in automatic run mode.	

	- Changed default font color to same than other texts - some page headers were
	  too hard to see with previous colors.



24.1.1999 - v1.07

	- Word hunter enhancement: You can now give a list of words from where hunter picks one.

	- Number of entries in user report is now controlled better and shouldn't grow too large.

	- Program rejects now all nicks who wrote 0 lines.

 	- Info screen added. Notifies the user for updated versions and news.

	- for IrcII and Eggdrop-users : if you don't remember to use ascii-mode in your 
	  log-transfers, mIRCStats still can read the log FTP'ed using binary mode.

	- Some minor updates for GUI and html-report. 

   	*** mIRC v5.5 has now an option to trim log files. This helps keeping log processing
	    times down. See mIRCStats FAQ or mIRC documentation for details.



20.12.1998 - v1.06

	- Background image support: Choose the image you want, mIRCStats will copy it to the
	  same folder with the html-file and bars. Then just upload contents of that folder 
	  to the server - that's it!

	  (hint: Very colorful background image makes the page totally unreadable!!
	   Mainly prefer ones you can find from the mIRCStats-folder.)


  --->	- Html header and footer support! - No more hacking with the page source! :P
	  Add your own piece of code to mircstatsheader.txt or/and mircstatsfooter.txt
 	  mIRCStats will then include those lines to the final report (provided that you 
	  had appropriate boxes checked..) 

 	  For those of you who release statistics for many channels, it's possible to 
	  define different kinds of headers and footers for every channel. Make them to
	  files like 'mychannelheader.txt' or 'mychannelfooter.txt' (for #mychannel)


	- Using same configs for channels like #bible and #deathmetal :) may lead to some 
	  kind of compromises - now you can make different configurations for every channel
          you run automatically. You can give the cfg-file as a parameter like this:

  	  	mircstats.exe c:\logs\#mychannel.log c:\stats\mychannel.html -c mychannel_weekly_config.cfg
	
	  Defining special channel configs goes like this: 
		- First run mircstats and set options, colours and files as you like.
		- Press button 'Save configs' (goes to 'settings.cfg')
	    	- Then copy 'settings.cfg' to 'mychannel_weekly_config.cfg' (for example..)

	
	- Fixed bug which caused 'Last N days'-selection not to work in the automode.


	- !! There has been 2 sights of a strange error which caused log reading to stop
	     in the middle of the file. The cause must have been that some person on a channel
             had pasted some ascii-crap there, and those characters must have included
	     the End-of-file mark, where mIRCStats stops reading.
          
             For similar errors, I added one line to the bottom of the html-source showing
             the last line which was read. Just copy that line and search for it in the log file, 
             so you should see some strange characters around that area. If you did, please send 
             me a copy of that area of the log file to ave@cc.tut.fi, so I can try to fix the
             program so that it wouldn't anymore jam in that position. 
		
	     Remove strange lines and save the log, so It will work again.
 


05.12.1998 - v1.05
	
  !!!	- Major optimizations in log handling, application speeded up 40% to 80% depending 
  !!!	  of the size of the log file !!!

	  Test run: 897 kB log file:

		mIRCStats v1.03 - "It took 39 seconds to create this page."
		mIRCStats v1.05 - "It took 9 seconds to create this page."
		----------------------------------------------------------
		Result: v1.05 was 77% faster than the previous version.

		
05.12.1998 - v1.04

	- Some parts added into 'Big Numbers'-section. Check them out...
	- Fixed that 'feature' which caused upgrade-popup to appear 3 months too early.. :P
	

19.11.1998 - v1.03

	- User interface fixes. (Earlier versions looked strange when using big fonts in Windows.
				 wonder why no-one reported this earlier..)
	- Some optimization in code.


10.10.1998 - v1.02
	
	- Command line parameters added. From now on you can run the program with any 
	  scheduler program and give the log name and result file as parameters.
	  Parameter format is: mircstats.exe [source log] [dest. html file]  
	
	  EXAMPLE:
		   mircstats.exe d:\mirc\logs\#paraakkeli.log c:\mircstats\today.html
		
	  !!! v1.06 addition: possibility to use channel specific cfg-files. 
		
	  EXAMPLE:
		   mircstats.exe d:\mirc\logs\#paraakkeli.log c:\mircstats\today.html -c paraakkeli_one_day_settings.cfg


	  mIRCStats runs then in AutoMode and uses configurations you have saved.  

	  (this makes it possible to schedule automatic update of various channels, try it!
	   You can also schedule a ftp program to automatically upload html's to web server)
	  

	- Word Hunter added - Choose a strange word and see who uses that word the most!
	- Minor document structure and colour fixes. 		


	- Eggdrop log handling now possible. Because Eggdrop doesn't include any date or
	  channelname info in the log file, you have to add 2 lines in the beginning 
	  of the log file.

	  Needed lines are these two:

Session Start: NOW Oct 10 00:00:00 1998
*** Now talking in #ChannelName
	
	  (Naturally you must use correct day info at the line #1)

	  mIRCStats uses this date and time as the base point to calculate times & dates.

31.8.1998 - v1.01

	- Some minor fixes

28.8.1998 - v1.0

	- Much more options (structure, parser, colours) to select from.
	- Configuration saving added.
	- Automatic run mode makes it possible to run the application as a scheduled task.

12.8.1998 - v1.0beta(4)
	Date format is not anymore dependant of windows' regional settings.

9.8.1998 - v1.0beta(3)
	Some minor fixes and ircII-style log reading added.

5.8.1998 - v1.0beta(2)
	Very disturbing crash bug fixed.

-------------------


Known bugs:
===========
- If log doesn't contain any 'normal' lines, you'll get the "div by zero" error.

-----------


Thanks
======

* To everyone who tested the beta version.


Please report bugs to ave@cc.tut.fi


>>> Author doesn't take any responsibility of any damage this program may cause you... 
    (wonder how it could do so..? :)