INSTALL.Linux

   1 Copyright (C) 2008 The Dasher Project
   2
   3 This file is free documentation; the Dasher Project gives unlimited
   4 permission to copy, distribute and modify it.
   5
   6 Basic Installation
   7 ==================
   8
   9 Dasher makes use of the GNU autotools system (automake, autoconf
  10 etc.), which are described in the 'INSTALL' file.  The following is
  11 specific to building and installing Dasher on Linux.  The Dasher
  12 maintainer documentation is at http://live.gnome.org/Dasher.
  13
  14 If you are building sources from the Subversion then you must first
  15 install all the packages required to build Dasher.  On Debian based
  16 distributions the following can be used.
  17
  18   packages="g++
  19             gnome-common
  20             gnome-doc-utils
  21             libatspi-dev
  22             libgconf2-dev
  23             libgtk2.0-dev
  24             libxtst-dev"
  25   sudo apt-get install $packages
  26
  27 Then autogen:
  28
  29   ./autogen.sh
  30
  31 Now you can use "configure" as described in the "INSTALL" file.  The
  32 following configure-time options are specific to Dasher (see section
  33 "`configure' Invocation" in the "INSTALL" file):
  34
  35 Options
  36 =======
  37
  38    --without-gnome     Disable features which require the GNOME core
  39                        libraries (enabled by default).
  40
  41    --with-speech       Enable GNOME-Speech support (disabled by default).
  42
  43    --disable-a11y      Disable support for GNOME accessibility features
  44                        (enabled by default). You should probably specify
  45                        this as well if you're using --without-gnome.
  46
  47    The following options include code which is significantly out of
  48 date and currently untested. It is likely that these options will not
  49 correctly build without modifications to the source code. If you are
  50 willing to invest some time in getting these up to date, please let us
  51 know!
  52
  53    --with-gpe          Build binaries for the GPE palmtop environment.
  54
  55    --with-qte          Build binaries using the QTE environment.
  56
  57 GSettings
  58 =========
  59
  60 Note that in the GNOME 3 world, GSettings, part of glib, replace
  61 GConf.  By default, dasher's "configure" will use GSettings if
  62 found.  If not it will use GConf if found.  This can be influenced
  63 by the --with-gsettings flag to configure.  If on running dasher,
  64 you see
  65
  66   GLib-GIO-ERROR **: Settings schema 'org.gnome.Dasher' is not installed
  67
  68   aborting...
  69
  70 try adding the directory which contains "dasher.gschema.xml",
  71 usually ${prefix}/share/glib-2.0/schemas, to the environment variable
  72 GSETTINGS_SCHEMA_DIR.