Gopher log analysis Readme

Current Version: 1.0	
Last Modified: 15/02/93
First created by: Jason W. Tice ( jtice@nero.uvic.ca )  29/01/93
Last midified by Modified by: jtice@nero.uvic.ca 15/02/93

Purpose of glas:

	The entire purpose of glas is to be able to analyze the gopher
	logfile into something coherent and, perhaps, understandeable.

	My first main goals were just to see what files are retrieved
	most often, and what kind of usage gopher was getting.  It 
	worked.

	Then I discovered gnuplot.... so, now we could graph some of
	the results (at least the traffic/usage of hte program).

	It appears to have been successful.


To get it running, read the INSTALL file.

Outstanding bugs:

	-	none yet known....  

Wishlist:

	-	some way of organizing weekly traffic report (text
		version) in monday, tuesday, wed... order

Version 1.0a	
	This version has NOT been heaavily tested.  it should work 
	fine, but many new lines of script were added for future
	enhancements (watch teh shell script grow and grow!)


To create your own analysis, this is the current GOPHER logfile layout:

fields:

		1	Day of week
		2	month
		3	day of month
		4	time
		5	year
		6	access no.
		7	machine
		8	":"
		9	"retrieved/root"
		10	"directory/file"
		11	dirnm/filenm

History:

version 1.0	15/02/93
	-	added more commentary in the script
	-	laid the ground-work for adding report-numbers to the command-line
	-	moved empty output-file check to the OUTPUT section
	-	rewrote new man page
	-	Created INSTALL file
	-	reset GNUPLOT to a variable--it seems to work now.


version 0.9	10/02/93
	-	fixed the gnuplot bug again--had to remove the set path 
		statement--nice idea but it didn't work.
	-	cleared up some of the spacing during the menu lines.

version 0.8     08/02/93
	-	Added Debugging output/option
	-	fixed a couple of reports
	-	had to change the gnuplot variable setting... it was
		calling the other gnuplot again --- AAAARGH!
	-	ensured that all reports lead to the loop again

version 0.7     06/02/93
	-	Made brief mode the only mode of access
	-	rewrote the output file lines - no longer bound to $cwd
	-	lots and lots of comments
	-	made sure $OUTF is removed only if the user wants

version 0.6     05/02/93
	-	Rewrote most of the script--included a complete brief mode
	-	full menu subsets -- an attempt (messy) at making it a little
		more of a hierarchical set-up  I don't like it.
	-	Added a bunch of new scripts:  14-22  for averages of specific
		files, machines, etc.
	-	no longer supports full command-line entries
	-	"glas c" - cron mode no logner supported
	-	"x" option for graphing reports now made a prompt option.
	-	a couple of syntactical changes, nothing major.
	-	removed $GFILE segment.  Not needed since LOGSOURCE will
		direct program to proper logfile.
	-	added "x" flag to brief mode--to signal an Xterminal
		for gnuplot graphs--if needed.

version 0.5	04/02/93
	-	Added report #13: average # of connections today.
	-	cleaned up some of the if statements.
	-	cleared up a noclobber annoyance

version 0.4	03/02/93
	-	prompts you for Gnuplot term
	-	worked around gnuplot bug (previous version I was using did
		not support a local .gnuplot file--now it does)
	-	Added entries to accept single-digit dates--a rather important
		limitation, I think.
	-	More comments throughout.
	-	support for gnuplot on a non-xwindow terminal
	-	corrected if(-e) starements in cron and brief mode
	-	set default cron report to report #12 (machines connected today)
	-	if glas doesn't see the gopherd-logfile in the current directory,
		it copies it from the host machine.

version 0.3	02/02/93
	-	added cron mode--this allows for multiple reports
		to go to one file without overwriting.  All cron mode
		reports (graphed reports wont work yet) are sent to
		the file "glascron.out"  Using "glas c [1-12]" will
		make it work
	-	added comments throughout the file to guide other people
	-	updated the man page
	-	removed all extraneous echoes to the screen
	-	made it so you can hit return all the way through the menu
		mode and you actually get a report--not a warning that
		you must read from a file...
	-	added report headlines, and graph labels
	-	fixed slight bug on report #12 (machines connected
		today) by making the logfile a variable...
	-	added command-line option "b" for brief...
		using "glas b" will set $GFILE to gopherd-logfile
		and $OUTF to glas-out. report type can be
		specified on  command-line as in curses menu version.

version 0.2 	01/30/93
	-	separated comments from program.
	-	gtmp now removed, regardless
	-	made sure $OUTF is removed only if created--not
		if calling for the help screen.

version 0.1     01/29/93
	-	created this mother


Final Note:

	If you find this at all useful, I'd love to hear about it.
	if you make any substantial modifications, I'd absolutely
	love a copy.  I know just enough to get the results I want, but
	anything that would speed this up, or make it do other things 
	would be greatly appreciated.

	Thanx

		Jason W. Tice
		jtice@nero.uvic.ca
