link looker++, the ultimate link looker, Copyright (c) November 1997 by Greg
Alexander.  This is to be distributed under the GNU Copyleft licensing
agreement distributed with this program in the file "COPYING".

	This is version 0.99, first public beta release.  It works.  It has
all of the tricky features already.  It does have neat commandline args, run
ll++ --help to see them.
	
Compiling:
	Type merely "make".  If that doesn't work, you're prolly screwed, 
E-Mail me the errors (if there are any):
under bash: 
make 2>&1|mail galexand@sietch.bloomington.in.us
under tcsh: 
make |&mail galexand@sietch.bloomington.in.us 
(if that doesn't work, figure it out for yourself) and I'll do my best to
figure it out.
	Running "make" should create the ll++ binary and several .o files. 
Feel free to delete the .o files.

Running:

usage: ll++ [options]
options:
-h,--help                   Shows this.
-s,--server <server>        Tells which server (with optional :port, 6667
            is default) connect to.  Not optional!
-f,--file <filename>        Reads a file instead of connecting to a server.
-S,--serverfile <filename>  Connects to the server, reads the file, shows
            the difference.  Saves the file again on exit (assuming you use
            the Quit button to exit).  Handy if you run this all day, exit
            at night, then want to see how it's changed when you get back.
-c,--checklink <seconds>    Checks links every that many seconds.
-C,--checklag <seconds>     Checks lag (like LagAll button) every that many
            seconds.  If this value is less than 60, you are dumb.

Example:
ll++ -s irc.phoenix.net:6668

	Would run the link looker on irc.phoenix.net, port 6668.  The server
isn't very important, it's just best if you are not lagged from the server
itself.
	Once it is loaded, it will grab a list of the links then spend about
a second doing stuff (neato-leato-burrito stuff).  It will then pop up the
window.
	If the meaning of most of the window at this time is not obvious to
you then you are highly advised to rm -rf this ASAP. :)
	This picture of the IRC network is not automatically updated (unless
you told it to be on the command line).  You have to hit the Links button in
order to tell it to update.  If you hit the Links button, it'll grab the
list again and then show the new display.  Servers that are highlit are new
to this update (i.e. they just split in), servers that are darker are old
servers that split away.  Links are shaded in the same manner.  This is
helpful so that you can see which links actually changed, as one link could
change and have moved 20 servers about your screen.
	Click on a server to select it (the name of the currently selected
server shows up in the lower-righthand corner).
	The buttons work as follows:
Quit		Quit
Links		Reload list of links between servers
Lag		Send out a TRACE thingy to the currenctly selected server. 
		This will tell you the lag between the servers along the
		route to the selected server.  The lag shows up as a number
		to the left of the server name.  It is measured in seconds.  
		It is mostly accurate.  This can be *extremely* handy for
		determining where the lag is and where a split is likely to 
		occur.
LagAll		Just like hitting Lag for every dead-end server.  Meaning
		that you'll get a lag time for every single server.
View		View what the IRC map would look like if the currently
		selected server were the root server, as if you had started
		ll++ connected to that server, except that it figures out what
		it would look like just based upon the link list already in 
		memory.
Thingy		Load a file 'thingy' which contains a modified LINKS output.
		Just a listing of all of the links in the form of two servers
		per a line.  Same as hitting links except not from the server.

Contacting me:
	I want to know if you use this program and if you find it useful!
	Please E-Mail me at:
		galexand@sietch.bloomington.in.us
or		gralexan@indiana.edu
	Check out my webpage at:
		http://sietch.home.ml.org/
or		http://cia-g.com/~sietch/

	Both of the alternates should be the same, the forwarding just
sometimes breaks down.

Modifying code:
	If you think of a modification, go for it.  E-Mail me either the
modification in a patch thingy if you can write it yourself, or E-Mail me
the idea.  If you find any bugs, please let me know.
	This program uses Otools, btw.  learn.txt is all the documentation I
can find on it.  The copy of Otools included here has been modified and is
rather attached to ll++...you can get an original Otools from your favorite
X consortium archive (if I recall correctly). 

Bugs:
	If the IRC server map changes drastically, sometimes it will show
just the root link covering the whole screen.  If this happens, restart
ll++.  If you read something in from a file, you'll probably have to update
that file.  If you can figure out specifics about this bug or if it makes
this program unusable for you, E-Mail me.
