forked from PsychoticNinja/irssi
Added real installation instructions to INSTALL file.
git-svn-id: http://svn.irssi.org/repos/irssi/trunk@2480 dbcabf3a-b0e7-0310-adc4-f8d773084564
This commit is contained in:
Timo Sirainen
cras
parent
ced46f8797
commit
7ebe053ebf
65
INSTALL
Normal file
65
INSTALL
Normal file
@ -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
|
||||
11
README
11
README
@ -3,11 +3,16 @@
|
||||
irssi, http://irssi.org
|
||||
|
||||
|
||||
* INSTALLATION
|
||||
|
||||
See INSTALL file.
|
||||
|
||||
|
||||
* FILES
|
||||
|
||||
- docs/ directory contains several documents:
|
||||
- startup-HOWTO.txt - new users should read this
|
||||
- manual.txt - manual I started writing but didn't get it finished :)
|
||||
- manual.txt - manual I started writing but didn't get it very far :)
|
||||
- perl.txt - Perl scripting help
|
||||
- formats.txt - How to use colors, etc. with irssi
|
||||
- faq.txt - Frequently Asked Questions
|
||||
@ -107,5 +112,5 @@ See TODO file if it is already listed in there - if not send me email..
|
||||
|
||||
- Timo Sirainen
|
||||
- tss@iki.fi
|
||||
- cras@ircnet/efnet/opn/silc
|
||||
- #irssi@ircnet/opn
|
||||
- cras at ircnet/opn/silc
|
||||
- #irssi at ircnet/opn, #irssi.fi at ircnet
|
||||
|
||||
@ -1,33 +1,9 @@
|
||||
Installation problems
|
||||
---------------------
|
||||
|
||||
You'll need to have perl support compiled with irssi. make install is
|
||||
also required to make them work. There's quite a many things that may
|
||||
go wrong with 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
|
||||
You'll need to have perl support compiled with irssi. If "/LOAD"
|
||||
doesn't show perl in list of loaded modules, you have a problem. See
|
||||
INSTALL file for information about perl problems.
|
||||
|
||||
|
||||
Running scripts
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user