INSTALL.Linux

Copyright (C) 2013 The Dasher Project
 
This file is free documentation; the Dasher Project gives unlimited
permission to copy, distribute and modify it.

Basic Installation
==================

Dasher makes use of the GNU autotools system (automake, autoconf
etc.), which are described in the 'INSTALL' file.  The following is
specific to building and installing Dasher on Linux.  The Dasher
maintainer documentation is at http://live.gnome.org/Dasher.

If you are building sources from the Git repository then you must
first install all the packages required to build Dasher.  On Debian
based distributions the following can be used.

  packages="g++
            gnome-common
            gnome-doc-utils
            libatspi2.0-dev
            libgtk-3-dev
            libspeechd-dev"
  sudo apt-get install $packages

Then autogen:

  ./autogen.sh

If the speech support is desired then

  ./autogen.sh --enable-speech=yes

After this, follow "Basic Installation" section in the "INSTALL" file.
For the "configure" step, the following configure-time options are
also available (see also the section "`configure' Invocation" in
the "INSTALL" file):

Options
=======

   --disable-speech    Disable speech support (speech dispatcher).

   --disable-a11y      Disable support for GNOME 2 accessibility features
                       (enabled by default).

   --disable-atspi     Disable support for GNOME 3 accessibility features
                       (enabled by default). This flag is just useful
                       for debugging, as accessibility is now built-in
                       and doesn't bring in more dependencies.

   The following options include code which is significantly out of
date and currently untested. It is likely that these options will not
correctly build without modifications to the source code. If you are
willing to invest some time in getting these up to date, please let us
know!

   --with-gpe          Build binaries for the GPE palmtop environment.

   --with-qte          Build binaries using the QTE environment.

GSettings
=========

Note that in the GNOME 3 world, GSettings, part of glib, replace
GConf.  By default, dasher's "configure" will use GSettings if
found.  If not it will use GConf if found.  This can be influenced
by the --with-gsettings flag to configure.  If on running dasher,
you see

  GLib-GIO-ERROR **: Settings schema 'org.gnome.Dasher' is not installed

  aborting...

try adding the directory which contains "dasher.gschema.xml",
usually ${prefix}/share/glib-2.0/schemas, to the environment variable
GSETTINGS_SCHEMA_DIR.

Desktop Shortcuts
=================
After the installation is done, for Ubuntu and derivatives
(e.g., Goobuntu), you can create desktop shortcuts starting Dasher in
different profiles by running:

  ./create-linux-desktop-shortcuts.sh

The Contributor’s Guide
=======================
If you would like to contribute to this project, please check out the following guide: https://docs.google.com/document/d/1qosKPV0GXbHs69PyvK9BR3S3oNgdV8il7AVfO1M4Fh4