INSTALL.Linux

   1 Copyright (C) 2013 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 Git repository then you must
  15 first install all the packages required to build Dasher.  On Debian
  16 based distributions the following can be used.
  17
  18   packages="g++
  19             gnome-common
  20             gnome-doc-utils
  21             libatspi2.0-dev
  22             libgtk-3-dev"
  23   sudo apt-get install $packages
  24
  25 Then autogen:
  26
  27   ./autogen.sh
  28
  29 After this, follow "Basic Installation" section in the "INSTALL" file.
  30 For the "configure" step, the following configure-time options are
  31 also available (see also the section "`configure' Invocation" in
  32 the "INSTALL" file):
  33
  34 Options
  35 =======
  36
  37    --disable-speech    Disable speech support (speech dispatcher).
  38
  39    --disable-a11y      Disable support for GNOME 2 accessibility features
  40                        (enabled by default).
  41
  42    --disable-atspi     Disable support for GNOME 3 accessibility features
  43                        (enabled by default). This flag is just useful
  44                        for debugging, as accessibility is now built-in
  45                        and doesn't bring in more dependencies.
  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.
  73
  74 Desktop Shortcuts
  75 =================
  76 After the installation is done, for Ubuntu and derivatives
  77 (e.g., Goobuntu), you can create desktop shortcuts starting Dasher in
  78 different profiles by running:
  79
  80   ./create-linux-desktop-shortcuts.sh