INSTALL

Prerequisites
=============

Gnome Commander requires the following packages:

- A working GNOME platform including glib 2.66, gtk+ 3, and gio 2.0
- meson

Gnome Commander can also make use of the following packages:

- libexiv2
- taglib
- libgsf
- poppler
- yelp for documentation

The minimum version requirements can be found in the top-level meson.config.

If you install GNOME Commander by manually compiling the sources, keep in
mind that on most Linux distributions you have to install the development
packages for the above libraries to be found by the configure script.
These packages are normaly indicated by a "-dev" or "-devel" suffix,
e.g. libgnome-dev, taglib-dev, etc.

Many package managers provide a way to install all the build dependencies for
a package, such as 'dnf builddep' or 'apt-get build-dep', which will install
almost all of the above. The requirements may have changed slightly between
the version packaged in the distribution and the current development version,
so you might have to install some additional packages.

Simple install procedure
========================

  % meson setup builddir                         # prepare the build
  % meson compile -C builddir                    # build Gnome Commander
  % meson install -C builddir                    # install Gnome Commander

This installs Gnome Commander to the default directory, usually under
'/usr/local/bin/'.

By default, the build will enable optional features if the packages they require
are installed. To check which options are available and which are enabled,
run 'meson configure builddir'.

Changing project options would then work as follows:
  % meson configure builddir -Doption=value

Uninstall procedure
===================

If you want to uninstall Gnome Commander again, run as root:

  % ninja -C builddir uninstall


The Details
===========

More detailed installation instructions can be found in meson's
website: https://mesonbuild.com/Quick-guide.html