INSTALL

   1
   2  Irssi installation instructions
   3  -------------------------------
   4
   5 To compile Irssi you need:
   6
   7 - meson-0.53 build system with ninja-1.8 or greater
   8 - glib-2.32 or greater
   9 - openssl (for ssl support)
  10 - perl-5.6 or greater (for Perl support)
  11 - terminfo or ncurses (for text frontend)
  12
  13 For most people, this should work just fine:
  14
  15  meson Build
  16  ninja -C Build
  17  su
  18  ninja -C Build install
  19
  20 meson options
  21
  22   These options can be given to meson.
  23
  24   For a complete list of options, run
  25    meson configure
  26
  27   --prefix
  28
  29   Specifies the path where Irssi will be installed.
  30   YES, you can install Irssi WITHOUT ROOT permissions
  31   by using --prefix=/home/dir
  32
  33   -Dwith-proxy=yes
  34
  35   Build the Irssi proxy (see startup-HOWTO).
  36
  37   -Dwith-perl=[yes|no]
  38
  39   Enable Perl support
  40   yes    enable builtin (default)
  41   no     disable
  42
  43   -Dwith-perl-lib=[site|vendor|DIR]
  44
  45   Specify installation dir for Perl libraries
  46   site   install in dir for site-specific modules (default)
  47   vendor install in dir for vendor-specific modules
  48   DIR    install in DIR
  49
  50   -Dwith-bot=yes
  51
  52   Build irssi-bot
  53
  54   -Dwithout-textui=yes
  55
  56   Build without text frontend
  57
  58 If anything is in non-standard path, you can just give the paths in
  59 the -Dc_args and -Dc_link_args options variable, eg.:
  60
  61   meson Build -Dc_args='-I/opt/openssl/include' -Dc_link_args='-L/opt/openssl/lib'
  62
  63
  64
  65  Perl problems
  66  -------------
  67
  68 Perl support generates most of the problems. There's quite a many
  69 things that can go wrong:
  70
  71  - If there's any weird crashing at startup, you might have older irssi's
  72    perl libraries installed somewhere, and you should remove those.
  73  - If meson complains that it doesn't find some perl stuff, you're
  74    probably missing libperl.so or libperl.a. In debian, you'll need to do
  75    apt-get install libperl-dev
  76
  77 You can verify that the perl module is loaded and working with "/LOAD"
  78 command. It should print something like:
  79
  80 Module               Type    Submodules
  81 ...
  82 perl                 dynamic fe core
  83
  84
  85  System specific notes
  86  ---------------------
  87
  88  Android
  89
  90 When cross compiling Irssi for Android, you can specify the path of
  91 the cross-perl in the cross file.
  92
  93 You may not have a cross-perl available. In that case, you will have
  94 to manually supply the required Perl arguments in the cross file. See
  95 the commented properties in the example cross file.
  96
  97 An example cross file can be found in the docs folder. To use it, you
  98 would call:
  99
 100   meson Build --cross-file cross-android-aarch64.txt \
 101     --prefix /data/data/com.termux/files/usr \
 102     --libdir lib \
 103     -Dfhs-prefix=/data/data/com.termux/files/usr \
 104
 105
 106  Cygwin
 107
 108 Getting perl scripting to work needs a few things:
 109
 110  - TODO