The INSTALL doc of emelfm2-0.1.0

INSTALL (text/plain), 2.08 KB, created by Tero Grundström on 2005-07-19 20:01:14 UTC

$Id: INSTALL 874 2005-06-15 07:42:16Z tpgww $

REQUIREMENTS
~~~~~~~~~~~~

Gtk+ >= 2.4 (http://www.gtk.org)
gcc >= 3.2 (http://gcc.gnu.org)

INSTALLATION
~~~~~~~~~~~~

make
make install

or
make PREFIX=/usr/local/stow/emelfm2
make install PREFIX=/usr/local/stow/emelfm2

HINT: you may want to edit Makefile.config for more path adjustments

some relevant make options:

DOCS_VERSION=1
causes the default docs dir name to include the current emelFM2
version no.

PANES_HORIZONTAL=1
causes the default file-pane layout to be top-to-bottom instead
of side-by-side

HELPDOC=MY-HELP-DOC
changes the name of the main user-guide document from the
default (USAGE) to MY-HELP-DOC

CONFIGDOC=MY-CFG-DOC
changes the name of the configuration help document from the
default (CONFIGURATION) to MY-CFG-DOC

USE_FAM=1
builds code for file-change monitoring using FAM instead of
monitoring the m/ctimes of the parent dir. Building requires 
FAM headers, but once built, it will run without FAM if need be

USE_GAMIN=1
builds code for file-change monitoring using gamin instead of
monitoring the m/ctimes of the parent dir. Building requires
gamin headers, but once built, it will run without gamin if need be
Source is available at www.gnome.org/~veillard/gamin/sources
NOTE don't use this if only FAM is available ! It will build
successfully, but crash when run !

Refer to file Makefile.cfg for some other less-notable build-time
options.

NOTE: If your filesysten encodes path/file names in something
other than utf-8 (which includes ascii) (e.g. with german umlauts),
to allow emelFM2 to handle them correctly you MUST:
1. include FILES_UTF8ONLY=0 as one of the make parameters
2. set the environment variable G_BROKEN_FILENAMES=1
You may also want to set LC_ALL=en_US or something similar.
If you set your locale to something like en_US.UTF-8, newer 
versions of Gtk+2 (>=2.4.0?) will ignore the G_BROKEN_FILENAMES
variable.

To cancel the effect of G_BROKEN_FILENAMES you have to unset the
environment variable, setting it to 0 is not enough!

UNINSTALLATION
~~~~~~~~~~~~

make uninstall

or
make uninstall PREFIX=/usr/local/stow/emelfm2