From 7ebe053ebfefbdd5fbdcada4235a51fadc7fce68 Mon Sep 17 00:00:00 2001 From: Timo Sirainen Date: Sat, 16 Feb 2002 12:52:19 +0000 Subject: Added real installation instructions to INSTALL file. git-svn-id: http://svn.irssi.org/repos/irssi/trunk@2480 dbcabf3a-b0e7-0310-adc4-f8d773084564 --- INSTALL | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 INSTALL (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL new file mode 100644 index 00000000..d9153e93 --- /dev/null +++ b/INSTALL @@ -0,0 +1,65 @@ + + Irssi installation instructions + ------------------------------- + +First of all, you need GLib to compile irssi. If you don't have it +already, you can either install it or let irssi download & compile it. +The automatic downloading works only if you have wget or ncftpget +installed, you can do it manually by unpacking glib sources to irssi's +root dir. + +For most people, this should work just fine: + + ./configure + make + su + make install (not _really_ required except for perl support) + +You may want to give some parameters to configure, here's the most +commonly used ones: + + --prefix - Specifies the path where irssi will be installed. + YES, you can install irssi WITHOUT ROOT permissions + by using --prefix=/home/dir + --with-proxy - Build the irssi proxy (see startup-HOWTO). + --enable-ipv6 - Enable IPv6 support. + +If GLib or ncurses is installed installed in a non-standard path you can +specify it with --with-glib=/path and --with-ncurses=/path. + +Irssi doesn't really need curses anymore, by default it uses +terminfo/termcap directly. The functions for using terminfo/termcap +however are usually only in curses library, some systems use libtermcap +as well. If you want to use only curses calls for some reason, use +--without-terminfo. + + + Perl problems + ------------- + +Perl support generates most of the problems. There's quite a many +things that can go wrong: + + - Perl 5.004 doesn't work by default, you'll need to edit + src/perl/irssi-core.pl and remove all lines with "delete_package" + in them. + - Compiling fails if you compile irssi with GCC in a system that has + perl compiled with some other C compiler. Very common problem with + non-Linux/BSD systems. You'll need to edit src/perl/*/Makefile files + and remove the parameters that gcc doesn't like. Mostly you'll just + need to keep the -I and -D parameters and add -fPIC. + - If there's any weird crashing at startup, you might have older irssi's + perl libraries installed somewhere, and you should remove those. + - Dynamic libraries don't want to work with some systems, so if your + system complains about some missing symbol in Irssi.so file, configure + irssi with --with-perl-staticlib option (NOT same as --with-perl=static). + - If configure complains that it doesn't find some perl stuff, you're + probably missing libperl.so or libperl.a. In debian, you'll need to do + apt-get install libperl-dev + +You can verify that the perl module is loaded and working with "/LOAD" +command. It should print something like: + +Module Type Submodules +... +perl static core fe -- cgit v1.2.3