X-Git-Url: http://git.pk910.de/?p=ircu2.10.12-pk.git;a=blobdiff_plain;f=INSTALL;fp=INSTALL;h=41b6e815f1ae37c6e33b52330ca0d7cd204f84ea;hp=0000000000000000000000000000000000000000;hb=0400a5a6479398d82526785c18c0df8bc8b92dce;hpb=d17e10da972ce5776c60b4c317267c6abe0e1ead diff --git a/INSTALL b/INSTALL new file mode 100644 index 0000000..41b6e81 --- /dev/null +++ b/INSTALL @@ -0,0 +1,61 @@ + +ircu - INSTALL + Original by Run , + Isomer , and Kev + Rewritten by Sengaia + Updated by Entrope + +Compiling and installing ircu should be a fairly straightforward process, +if you have obtained this software as a (.tar.gz) package, please consider +using CVS (described below). Using CVS will make updating your installation +much easier. + +After obtaining the latest version of the ircu source code, change into the +source directory (ircu2.10.xx.yy), and run "./configure". To see the various +ways in which you can customize your installation, run "./configure --help". + +The configure process will check your environment and prepare itself for +compiling the source code. If one or more of the prerequisites cannot be +found, configure will terminate with an error. You will need to resolve +this and run configure again. + +If configure runs without error(s), you are ready to compile. To compile ircu, +run "make". Please use GNU make and gcc. If the source code does not compile, +make sure your environment is setup correctly. If you are convinced the source +of the failure is ircu, gather all relevant information about your system such +as the Architecture, OS version, the configure statement you used, etc. and +contact coder-com@undernet.org. + +Once ircu is compiled, install it by running "make install". + +Next, you will have to configure your IRC server by setting up your ircd.conf +file. Use the included doc/example.conf as a starting point; it is installed +in $HOME/lib/example.conf by default. +Setting up ircd.conf can be a bit tricky, so if this is your first time doing +it, begin with a bare-bones configuration and extend it as you go. + +If you are upgrading from ircu2.10.11, use the ircd/convert-conf +program to convert your existing configuration file(s). It is +compiled during "make" and installed to $PREFIX/bin/convert-conf. + +Good Luck! + +RETRIEVING IRCU VIA CVS + +The recommended way to get the ircu package now is to use CVS. CVS makes +upgrades a lot less painful and lets you get the latest package. + +The first thing you need to do is login to the cvs server: +# cvs -d :pserver:anonymous@cvs.undernet.org:/cvsroot/undernet-ircu login + +(we recommend that you cut and paste the above line to use it :) +When it prompts you for a password hit enter since there isn't one. + +To check out the the last development version of ircu, use: +# cvs -d :pserver:anonymous@cvs.undernet.org:/cvsroot/undernet-ircu co -P ircu2.10 +The latest stable version has a tag name that depends on the version +number; see doc/readme.cvs for details. + +To update your source tree to the latest version, run "cvs update -dP" from within the +ircu2.10 directory. For more information, see http://coder-com.undernet.org. +