From: fer@home.cern.ch (Fer F.de Jong)
Subject: BI-WEEKLY: How to compile and install an IRC-II client
Followup-To: alt.irc
Keywords: IRCII CLIENT
Organization: CERN European Lab for Particle Physics
Date: Wed, 18 Nov 1992 02:00:04 GMT

[ If you don't want to see this posting everytime, use the KILL file
  feature of your newsreader. ]

[ Special thanks to ian for his remarks and suggestions to the last version ]


How to get the IRC-II client software and install it
====================================================


To install an IRC-II client on your machine follow this procedure. People
that want to install IRC for global use should be able to change the
described procedure so the files go in an /usr/local/bin like place.

On your UNIX system type:

fer@home:~fer> mkdir irc
fer@home:~fer> cd irc
fer@home:~fer/irc> ftp cs.bu.edu
[ login as user anonymous ]
[ type your e-mail address when asked for a password ]
ftp% bin
ftp% cd irc
ftp% get ircII2.1.5h.help.tar.Z
ftp% get ircII2.1.5h.tar.Z
ftp% bye
fer@home:~fer/irc> 

Now you have copied all the files needed for compilation and installation.
Now type on your UNIX system:

fer@home:~fer/irc> zcat ircII2.1.5h.tar.Z | tar xvf -
fer@home:~fer/irc> cd ircII2.1.5h
fer@home:~fer/irc/ircII2.1.5h> 

Read the file INSTALL that explains how to compile and install the whole
IRC system:
The important settings that need to be made are in the files Makefile
and config.h. Pay special attention to:

In config.h: set DEFAULT_SERVER to an IRC server site close to you.
	If you don't know any IRC server pick one from this list:

		ircserver.et.tudelft.nl (For The Netherlands / Belgium)
		suntrax1.cern.ch	(For Switzerland)
		noc.belwue.de		(For Germany)
		nic.funet.fi		(For Scandinavia)
		csd.bu.edu		(For Eastcoast U.S.A.)
		badger.ugcs.caltech.edu	(For Westcoast U.S.A.)
		penfold.ece.uiuc.edu	(For Midwest U.S.A.)
		ug.cs.dal.ca		(For Canada)
		decscc.tau.ac.il	(For Israel)
		
In config.h: Check all other #define's, check the path to zcat and
correct the error (forgotten /* at start of AUTO_RECONNECT #define),
set HELP_SERVICE to help_UK or help_AU or help_US or ircIIhelp depending
on where you are.

In Makefile:
INSTALL_EXECUTABLE = your_homedir/bin/irc
IRCII_LIBRARY = your_homedir/lib/irc		(Create these directories
						 yourself and put the bin
INSTALL_IRCFLUSH = your_homedir/bin/ircflush     directory in your $PATH)

Set the DEFINES= line by removing the # at the beginning of the one
that is ment for your hardware setup.

Now you can 'make' the whole thing and it should work without any
problem. Don't ask me for help if it doesn't work. Ask a local expert.

fer@home:~fer/irc/ircII2.1.5.h> make
fer@home:~fer/irc/ircII2.1.5.h> make ircflush
fer@home:~fer/irc/ircII2.1.5.h> make install
fer@home:~fer/irc/ircII2.1.5.h> make installflush

In the directory your_homedir/lib/irc you should make a file called servers
with a list of all the servers you want to try to connect to. If the default
server (top line) does not work (machine down, links to machine don't work...)
your IRC client will try to connect to the next machine in the list.
The file should look something like:

default.machine.domain
second.choise.machine
third.choise.machine
last.hope.for.connection.machine

Always try to find IRC servers that are network-wise close to where you are.
Note that the contents of this file will override the DEFAULT_SERVER setting
in config.h, so after you have compiled IRC try to find out the best server
and put that one at the top of your servers file.

Now you have to install the script files and help files that will make
your IRC life easier.


fer@home:~fer/irc/ircII2.1.5.h> cp -r script $HOME/lib/irc
fer@home:~fer/irc/ircII2.1.5.h> cd
fer@home:~fer> cd lib/irc
fer@home:~fer/lib/irc> zcat $HOME/irc/ircII2.1.5h.help.tar.Z | tar xvf -
fer@home:~fer/lib/irc> compress help/*
fer@home:~fer/lib/irc> compress help/*/*

Don't mind the error messages of the last two commands, these are normal.

If you want to allow others to use IRC, don't forget to use the chmod(1)
command to make the files and directories available.

It might seem a lot of work, but you can have a lot of fun with IRC
so it is worth a try.

To learn to use IRC, type after you started IRC with,

fer@home:~fer/lib/irc> irc Ferry

the command /help basical and /help ircII. (/bye quits your IRC client)

If all works fine, you can delete the whole directory structure used to
build IRC with:

fer@home:~fer/lib/irc> cd
fer@home:~fer> # The command  rm -rf  will remove ALL arguments
fer@home:~fer> # even directories AND all subdirectories BE WARNED
fer@home:~fer> rm -rf irc
fer@home:~fer> 


	Have fun, and keep in mind, *some* people get addicted to IRC!

-- 
 ___   fer@home.cern.ch    European Organization For Nuclear Research
(  _)  <Ferry> @ IRC
 ) _)                         "The number two is the oddest prime you
(_)er F.de Jong                                 will ever encounter."
+41 22 767 3826 (office/Switzerland) +33 50.42.74.13 (private/France)
Newsgroups: alt.irc