Post-release rev bump
[claws-win32-installer.git] / INSTALL
1 Installation Instructions
2 *************************
3
4 The build has been tested on Debian 8.0 (Jessie) and 9.0 (Stretch). It
5 will likely work on other Linux distributions also, if the necessary
6 tools are installed. About 6GB of disk space will be needed.
7
8 First, following packages need to be installed:
9
10 apt-get install \
11 mingw-w64 gcc automake make unzip stow nsis gettext libgettextpo-dev \
12 graphicsmagick-imagemagick-compat pkg-config libglib2.0-dev bison flex \
13 libgdk-pixbuf2.0-dev intltool gperf docbook-utils libswitch-perl
14
15 These packages will pull in lot of other packages as dependencies, around
16 400MB in total.
17
18 Important: If you are on Debian Stretch, you need to make sure older
19 mingw-w64 version 3.x is installed, as mingw-w64 versions 4.x come with
20 a broken libstdc++. Use Debian snapshot archive if needed.
21 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=736946 for details.
22
23 If your flex version is less than 2.60, delete file
24 patches/webkit-1.3.10/03-maketokenizer-flex2.60.patch.
25
26 Latest installer source can be found in git repository, if building from
27 a release tarball (claws-mail-win32-x.y.z-N.tar.bz2) is not what you want:
28   git clone http://git.claws-mail.org/readonly/claws-win32-installer.git
29         cd claws-win32-installer
30
31 Download source code for all the software we will be building:
32   cd packages
33         sh download.sh
34         cd ..
35
36 Prepare the tree for building:
37   ./autogen.sh
38         ./autogen.sh --build-w32
39
40 And finally, if everything is in its place, start the build with:
41   make
42
43 Do not use -j switch for make, the build system will automatically add it
44 to make commands for individual software packages, based on number of CPUs
45 on your system.
46
47 The build will take a long time, possibly over an hour. As already mentioned,
48 It will require about 6GB of disk space.
49
50 When all is done, the installer .exe can be found in src/ subdirectory. If
51 you also want to build the sources, you can do so with command:
52   make dist