Group: IceCat/Compile and package/build 52.6.0 on Devuan 2.0.0 ASCII 64bit

{{Languages|master page=build_52.6.0_on_devuan_2.0.0_ascii_64bit|language=en}}

__TOC__

* The information contained in this page is current as of: 2018-07-14.
* The text in this page was last modified on: {{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY}}.

== Introduction ==

This page contains a report, with comments and hints, on a successful build of '''[https://www.gnu.org/software/gnuzilla/ Gnuzilla IceCat 52.6.0] [https://ftp.gnu.org/gnu/gnuzilla/52.6.0/] (-gnu1)''' on a updated (2018-07-14) '''[https://www.devuan.org/ Devuan GNU+Linux] 2.0.0 ASCII''' <tt style="font-weight:700;">amd64</tt> machine.

'''[https://www.devuan.org/ Devuan GNU+Linux]''' is a fork of '''[https://www.debian.org/ Debian]''' without <tt style="font-weight:700;">systemd</tt>. Devuan's stable release is now '''[https://devuan.org/os/debian-fork/ascii-stable-announce-060818/ 2.0.0 ASCII]''' which provides a flawless switch from Debian 9.0 (Stretch) that ensures the right to [https://devuan.org/os/init-freedom Init Freedom] and avoids entanglement.

The procedure below should also apply, eventually with some differences, to other distributions based on '''[https://www.devuan.org/ Devuan GNU+Linux] ASCII''' and '''[https://www.debian.org/ Debian] Stretch'''.

'''IMPORTANT NOTE''': The reccomended way to run commands is from a Bash terminal. Avoid any graphical tool!

== Prepare the developing environment ==

* '''System update'''
First of all, it is highly reccomended having an updated system:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
 $ sudo apt-get update
 $ sudo apt-get upgrade
</pre>

* '''Install common development tools'''
The most common development tools should be installed on your system. Please install (this is required only once):
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ sudo apt-get install gcc g++ make patch perl python unzip zip
$ sudo apt-get install autoconf automake build-essential checkinstall debhelper devscripts dpkg-dev fakeroot gdb-minimal libc6 libc6-dev libtool intltool pbuilder pkg-config 
</pre>

* '''Install and configure <tt style="font-weight:700;">ccache</tt>'''
To speed up the build process (see below), install <tt style="font-weight:700;">ccache</tt>:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ sudo apt-get install ccache
</pre>
You should create a directory where storing <tt style="font-weight:400;">cccache</tt> files:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ mkdir <ccache_basepath>/ccache
</pre>
where:
: <tt style="font-weight:400;"><ccache_basepath></tt>: is the full path of a directory you should choose as base where storing <tt style="font-weight:400;">cccache</tt> files
And when opening a shell you should configure <tt style="font-weight:700;">ccache</tt>:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ export CCACHE_DIR=<ccache_basepath>/ccache
$ ccache --max-size <N>G
$ export CCACHE_COMPRESS=""
</pre>
where:
: <tt style="font-weight:400;"><ccache_basepath></tt>: is the full path of a directory you should choose as base where storing <tt style="font-weight:400;">cccache</tt> files
: <tt style="font-weight:400;"><N></tt>: is the maximum size (in GB) of the cache
To avoid configuring <tt style="font-weight:400;">cccache</tt> everytime, you could append the configuration to your <tt style="font-weight:700;">~/.bashrc</tt>.

== Prepare the requested libraries and dependencies ==

To successfully build '''[https://ftp.gnu.org/gnu/gnuzilla/52.6.0/ Icecat 52.6.0]''' you need some libraries to be installed and some dependencies to be satisfied. Please install (this is required only once):

* '''Default IceCat libraries'''
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ sudo apt-get install libpango libpangoxft libpangoft2 libfreetype libxft libgtk2 libx11
</pre>

''(see: <tt style="font-weight:400;">'README.IceCat'</tt> file contained in the [http://ftp.gnu.org/gnu/gnuzilla/52.6.0/icecat-52.6.0-gnu1.tar.bz2 IceCat 52.6.0-gnu1 sources])''

* '''Linux environment files'''
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ sudo apt-get install gcc-4.9 perl make libgtk2.0-dev libgtk-3-dev libxt-dev libidl-dev libx11-xcb-dev zip libfreetype6-dev fontconfig libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev pkg-config libdbus-glib-1-dev libasound2-dev libpulse-dev libasound2-dev libnotify-dev yasm libpython2.7-dev python2.7 python2.7-dev autoconf2.13 m4 binutils-avr libgl1-mesa-dev
</pre>
'''IMPORTANT NOTE''': These versions are required: gcc >=4.9, perl >= 5.6, GNU make >= 3.80, gtk2 >= 2.10, gtk3 >= 3.4, libidl >= 0.6.3, zip >= 2.3, freetype >= 2.1.0, pkg-config >= 0.9.0, gstreamer >= 0.10, yasm >= 1.1.0, python >= 2.7.3 (python 3 will NOT work!), autoconf=2.13 (requires GNU m4) (Autoconf 2.5x will NOT work!)  

''(see: [https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Linux_Prerequisites/ Linux_Prerequisites] at the [https://developer.mozilla.org/ Mozilla Developer Network])''.

* '''Other suggested libraries and dependencies'''
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ sudo apt-get install libatk libc6 libcairo2 libffi6 libffi-dev libfontconfig1 libfreetype6 libgcc1 libgtk-pixbuf2 libglib2.0 libgtk2 libhunspell-dev libstdc libx11 libx11-xcb-dev libcomposite1 libxdamage1 libxext6 libfixes3 libxrender1 libxt6 zlib1g procps debianutils libsqlite3 libsqlite3-dev libxml2-dev libglib2.0-dev libevent-dev libnss3-dev libiw-dev libglu1-mesa-dev xulrunner-dev python-virtualenv python-pip lbzip2 libicu-dev
</pre>
To install all system prerequisites you can try to run the following:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ sudo apt-get install build-dep firefox-esr
$ wget -O bootstrap.py https://hg.mozilla.org/mozilla-central/raw-file/default/python/mozboot/bin/bootstrap.py && python bootstrap.py
</pre>
Other packages and libraries could be necessary depending on the build options you choose (see below).

== Prepare the building environment ==

'''IMPORTANT NOTE''': Every time the build process fails, it is highly recommended to '''repeat all the entire process''', starting again '''from a completely clean building environment''' (see here below): cleaned and cleared <tt style="font-weight:700;">ccache</tt>, empty <tt style="font-weight:700;">src</tt> and <tt style="font-weight:700;">obj</tt> directories etc. A system reboot is also suggested.

The building environment should be set up before to start the building process. Please do the following:

* '''Clean and check <tt style="font-weight:700;">ccache</tt>'''
If <tt style="font-weight:700;">ccache</tt> is in use, it should be clear and clean:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ ccache --clear --cleanup
$ ccache -s
</pre>

* '''Set the building base directory'''
You should have a directory to use as base for all the building process:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ cd <build_basepath>
$ mkdir icecat-52.6.0
$ cd icecat-52.6.0
</pre>
where:
: <tt style="font-weight:400;"><build_basepath></tt>: is the path of a directory you should choose as base for all the building process
: <tt style="font-weight:400;">icecat-52.6.0</tt>: is the sub-directory of <build_basepath> where to work

* '''Download the sources'''
To download the sources into the <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0</tt> directory, please run:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ curl -O -J -L 'https://ftp.gnu.org/gnu/gnuzilla/52.6.0/icecat-52.6.0-gnu1.tar.bz2' 
$ curl -O -J -L 'https://ftp.gnu.org/gnu/gnuzilla/52.6.0/icecat-52.6.0-gnu1.tar.bz2.sig' 
</pre>

* '''Verify the downloaded sources'''
The '''[https://www.gnu.org/software/gnuzilla/ Gnuzilla IceCat]''' releases are signed with a gpg key. The new gpg key has ID: <tt style="font-weight:700;">D7E04784</tt>. 
Please download the key and check its fingerprint:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ gpg --keyserver keys.gnupg.net --recv-keys D7E04784
$ gpg --fingerprint D7E04784
</pre>

The fingerprint of the gpg key used to sing the '''[https://www.gnu.org/software/gnuzilla/ Gnuzilla IceCat]''' releases should be:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
A573 69A8 BABC 2542 B5A0  368C 3C76 EED7 D7E0 4784
</pre>

Then verify the downloaded sources:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ gpg --verify icecat-52.6.0-gnu1.tar.bz2.sig 
</pre>

* '''Prepare the sources'''
To prepare the sources tree in the <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0/src</tt> directory, please run (please, '''avoid''' using any graphical tool when decompressing surces!):
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ tar -jxvf icecat-52.6.0-gnu1.tar.bz2
$ mv icecat-52.6.0  src
</pre>

== Configure the build ==

Configuration of the build process could be obtained through:
; - configuration parameters
: which can be passed to the command script <tt style="font-weight:700;">configure</tt> as command-line parameters (discouraged) or, better, through a configuration file named <tt style="font-weight:700;">src/mozconfig</tt> which should be created into the source directory (reccomended)
; - configuration variables
: which can be set via the <tt style="font-weight:700;">src/browser/confvars.sh</tt> file

The configuration parameters are used by the command script <tt style="font-weight:700;">configure</tt> to set the corresponding configuration variables.

Please note that *not* all the configuration variables can be set through the command script <tt style="font-weight:700;">configure</tt>: these variables can be set only directly in the <tt style="font-weight:700;">src/browser/confvars.sh</tt> file.

For more detailed information, please see:
* [https://firefox-source-docs.mozilla.org/ Firefox source documentation]  
* [https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Configuring_Build_Options/ Build options]  

==== Set the configuration parameters (file: <tt style="font-weight:700;">src/mozconfig</tt>) ====

A complete list of the available parameters can be obtained running (from the source tree base directory):
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ ./configure --help
</pre>

The reccomended way to set any of the '''''configuration parameters''''' is through a configuration file <tt style="font-weight:700;">src/mozconfig</tt> which should be created into the source directory. Calling <tt style="font-weight:700;">configure</tt> with command-line options is discouraged.

Use your favourite text editor to create this <tt style="font-weight:700;">src/mozconfig</tt> file and modify it if necessary.

Here below is listed the content of the <tt style="font-weight:700;">src/mozconfig</tt> file which '''is needed''' building '''[https://ftp.gnu.org/gnu/gnuzilla/52.6.0/ IceCat 52.6.0]''' as suggested in this document. 

Please note that:
* this file has been successfully tested building '''[https://ftp.gnu.org/gnu/gnuzilla/52.6.0/ IceCat 52.6.0]''' on a updated (2018-07-14) '''[https://www.devuan.org/ Devuan GNU+Linux] 2.0.0 ASCII''' <tt style="font-weight:700;">amd64</tt> machine
* '''before to start the build process is *highly reccomended* to check carefully all the content of this file''', in order to comment/uncomment the options accordingly with your system and your preferences
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
#### 
####  icecat 'src/mozconfig' file
#### 

## Linux_Prerequisites - see: https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Linux_Prerequisites
## Build options - see: https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Configuring_Build_Options
## Source documentation - see: https://firefox-source-docs.mozilla.org/

### IMPORTANT NOTICE: 
### add the following lines to the VERY BOTTOM of 'src/mozconfig'

### WARNING: the following lines should NOT be changed
## Mozilla requires Python2 (python3 will NOT work - see: Linux_Prerequisites)
mk_add_options PYTHON=/usr/bin/python2

### WARNING: the following lines should NOT be changed
### (from:  . "$topsrcdir/build/mozconfig.common")
mk_add_options AUTOCLOBBER=1
ac_add_options --enable-release
ac_add_options --enable-js-shell
ac_add_options --disable-eme

### WARNING: the following lines should NOT be changed
### (from:  . "$topsrcdir/src/browser/config/mozconfig")
## application to build
ac_add_options --enable-application=browser

### WARNING: the following one should be comment out if not using ccache
## build using ccache
ac_add_options --with-ccache

### WARNING: the following lines should NOT be changed
## build using an objdir (to keep sources clean)
mk_add_options MOZ_OBJDIR=$topsrcdir/../obj
## path: sources for locales
ac_add_options --with-l10n-base=$topsrcdir/l10n
## path: system install dir
ac_add_options --prefix=/usr

### WARNING: the following lines should NOT be changed
## build with optimization
ac_add_options --enable-optimize="-pipe -O2"
## default toolkit
ac_add_options --enable-default-toolkit=cairo-gtk2

### WARNING: the following lines should NOT be changed
## branding
ac_add_options --enable-official-branding
ac_add_options --with-distribution-id=org.gnu 
## enable support for user|portable fonts on desktop platforms (put your fonts 
## to dir browser/fonts, then you can select them in the font preferences)
ac_add_options --enable-bundled-fonts

### RECOMMENDED: NOT NECESSARY AND/OR PRIVACY RELATED STUFF

## disable geolocation services
ac_add_options --disable-necko-wifi
ac_add_options --disable-gpsd

## disable unwanted options 
ac_add_options --disable-debug
ac_add_options --disable-debug-symbols
ac_add_options --disable-tests 
ac_add_options --disable-crashreporter 
ac_add_options --disable-updater 
ac_add_options --disable-maintenance-service
ac_add_options --disable-parental-controls

### OTHER RECOMMENDED OPTIONS (uncomment/comment what you want/unwant)

## use alsa instead of pulseaudio (Alsa must be installed in your system!)
## WARNING: commentout BOTH the following two lines to use pulseaudio
ac_add_options --enable-alsa  
ac_add_options --disable-pulseaudio 

## jack audio backend
ac_add_options --enable-jack 

## raw support
ac_add_options --enable-raw

## if dbus-glib is installed you could uncomment the next line
ac_add_options --disable-dbus

## if gconf is installed you could uncomment the next line
ac_add_options --disable-gconf
</pre>

==== Set the configuration variables (file: <tt style="font-weight:700;">src/browser/confvars.sh</tt>) ====

Some configuration variables can only be set directly, editing the <tt style="font-weight:700;">src/browser/confvars.sh</tt> file provided with the sources.

Use your favourite text editor to modify the <tt style="font-weight:700;">src/browser/confvars.sh</tt> file if necessary.

Please note that:
* a deep knowledge and comprehension of the source code and the build process is needed to safely modify this file 
* the documentation about these variables is often poor and/or unclear
* '''is *highly reccomended* to avoid unnecessary changes in this file''' if in dubt

Here below are listed some variables settings which can be safely add (trying to increase privacy) '''at the VERY BOTTOM''' of the <tt style="font-weight:700;">src/browser/confvars.sh</tt> file in order to build '''[https://ftp.gnu.org/gnu/gnuzilla/52.6.0/ IceCat 52.6.0]''' as suggested in this document. 

Please note that:
* this file has been successfully tested building '''[https://ftp.gnu.org/gnu/gnuzilla/52.6.0/ IceCat 52.6.0]''' on a updated (2018-07-14) '''[https://www.devuan.org/ Devuan GNU+Linux] 2.0.0 ASCII''' <tt style="font-weight:700;">amd64</tt> machine
* '''before to start the build process is *highly reccomended* to check carefully all the content of this file''', in order to set/unset variables accordingly with your preferences
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
### 
###  icecat 'src/browser/confvars.sh' APPEND file
### 

## IMPORTANT NOTICE:
## append the following lines to the VERY BOTTOM of 'src/browser/confvars.sh'

## Extra IceCat settings
MOZ_APP_VENDOR=GNU
MOZ_APP_VERSION=52.6.0
MOZ_APP_PROFILE=mozilla/icecat
MOZ_ANDROID_GOOGLE_PLAY_SERVICES=
MOZ_BUNDLED_FONTS=1
MOZ_CRASHREPORTER=
MOZ_CRASHREPORTER_DISABLE=1
MOZ_DATA_REPORTING=
MOZ_DEVICES=
MOZ_SERVICES_FXACCOUNTS=
MOZ_SERVICES_HEALTHREPORT=
MOZ_SERVICES_HEALTHREPORTER=
MOZ_SERVICES_METRICS=
MOZ_SERVICES_SYNC=
MOZ_SOCIAL=
MOZ_TELEMETRY_REPORTING=
MOZ_UPDATER=
MOZ_ADDON_SIGNING=
MOZ_PAY=
MOZ_SERVICES_BLOCKLISTS=
MOZ_SERVICES_CLOUDSYNC=
</pre>

== Build ==

Building the binaries means run <tt style="font-weight:700;">configure</tt> and <tt style="font-weight:700;">make</tt>. It 'a heavy task, requiring significant system resources and can last for a very long time. Building as suggested in this document, on a machine with a 64bit CPU 4-core 3.8GHz, 16GB RAM and using <tt style="font-weight:700;">ccache</tt>, takes about 25 minutes.

* '''Prepare the directory <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0/obj</tt> where to build'''
The build will take place in a separate so-called <tt style="font-weight:700;">objdir</tt> sub-directory (whose path has been previously set in the <tt style="font-weight:700;">src/mozconfig</tt> file), in order to leave clean the sources tree.:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ mkdir obj
$ cd obj
</pre>

* '''Run <tt style="font-weight:700;">configure</tt>'''
Staying in the <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0/obj</tt> directory, please run:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ ../src/configure
</pre>

or, if you want to capture and save the output of the command to the terminal:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ ../src/configure  2>&1 | tee config.txtout
</pre>

If saved as above (using <tt style="font-weight:700;">tee</tt>), the command script output to the terminal will be in the <tt style="font-weight:700;">config.txtfile</tt> file.

The command script log will be in the <tt style="font-weight:700;">config.log</tt> file.

* '''Run <tt style="font-weight:700;">make</tt>'''
Staying in the <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0/obj</tt> directory, please run:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ make -j<N> -f ../src/client.mk
</pre>

or, if you want to capture and save the output of the command to the terminal:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ make -j<N> -f ../src/client.mk  2>&1 | tee make.txtout
</pre>
where:
: <tt style="font-weight:400;"><N></tt>: is the number of the CPU cores/threads you want to be used during the compilation

If saved as above (using <tt style="font-weight:700;">tee</tt>), the command script output to the terminal will be in the <tt style="font-weight:700;">make.txtfile</tt> file.

* '''Langpack ''(optional)'''''

You can simply download the pre-built '''[https://ftp.gnu.org/gnu/gnuzilla/52.6.0/langpacks/ IceCat 52.6.0 langpacks]''' which you need. 

Otherwise, if you prefer to build yourself a langpack, please run:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ cd browser/locales
$ make langpack-$LANG LOCALE_MERGEDIR=.
$ cd ../..
</pre>
where:
: <tt style="font-weight:400;">$LANG</tt>: is the locale of the langpack to build

== Install ==

After the building process has been successfully completed, you might want to install '''[https://www.gnu.org/software/gnuzilla/ Gnuzilla IceCat]''' on your system.

==== Standalone installation ====

To install the binaries as a "standalone" program, staying in the <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0/obj</tt> directory, please run:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ make install DESTDIR=<build_basepath>/icecat-52.6.0/bin
</pre>

or, if you want to capture and save the output of the command to the terminal:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ make install DESTDIR=<build_basepath>/icecat-52.6.0/bin  2>&1 | tee install.txtout
</pre>
where:
: <tt style="font-weight:400;"><build_basepath></tt>: is the '''*absolute* path''' of a directory you should choose as base for all the building process

If saved as above (using <tt style="font-weight:700;">tee</tt>), the command script output to the terminal will be in the <tt style="font-weight:700;">install.txtfile</tt> file.

The "standalone" binaries will be generated into the <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0/bin/usr/lib/icecat-52.6.0</tt> directory.

To install, just copy the directory with the "standalone" binaries in an appropriate place to be used in your system. A common suggested place is <tt style="font-weight:700;">/opt/icecat</tt>.

==== Tarball package creation ====

To create a binary tarball, staying in the <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0/obj</tt> directory, please run:
<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word; font-weight:400;">
$ cd browser/installer
$ make
$ cd ../..
</pre>

The tarball package will be generated into the <tt style="font-weight:700;"><build_basepath>/icecat-52.6.0/obj/dist</tt> directory.


Enjoy '''[https://www.gnu.org/software/gnuzilla/ Gnuzilla IceCat]'''!

----
''[ Document edited by: [[User:Alexus|alexus]] ]''