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             libspeechd-dev"
  24   sudo apt-get install $packages
  25
  26 Then autogen:
  27
  28   ./autogen.sh
  29
  30 If the speech support is desired then
  31
  32   ./autogen.sh --enable-speech=yes
  33
  34 After this, follow "Basic Installation" section in the "INSTALL" file.
  35 For the "configure" step, the following configure-time options are
  36 also available (see also the section "`configure' Invocation" in
  37 the "INSTALL" file):
  38
  39 Options
  40 =======
  41
  42    --disable-speech    Disable speech support (speech dispatcher).
  43
  44    --disable-a11y      Disable support for GNOME 2 accessibility features
  45                        (enabled by default).
  46
  47    --disable-atspi     Disable support for GNOME 3 accessibility features
  48                        (enabled by default). This flag is just useful
  49                        for debugging, as accessibility is now built-in
  50                        and doesn't bring in more dependencies.
  51
  52    The following options include code which is significantly out of
  53 date and currently untested. It is likely that these options will not
  54 correctly build without modifications to the source code. If you are
  55 willing to invest some time in getting these up to date, please let us
  56 know!
  57
  58    --with-gpe          Build binaries for the GPE palmtop environment.
  59
  60    --with-qte          Build binaries using the QTE environment.
  61
  62 GSettings
  63 =========
  64
  65 Note that in the GNOME 3 world, GSettings, part of glib, replace
  66 GConf.  By default, dasher's "configure" will use GSettings if
  67 found.  If not it will use GConf if found.  This can be influenced
  68 by the --with-gsettings flag to configure.  If on running dasher,
  69 you see
  70
  71   GLib-GIO-ERROR **: Settings schema 'org.gnome.Dasher' is not installed
  72
  73   aborting...
  74
  75 try adding the directory which contains "dasher.gschema.xml",
  76 usually ${prefix}/share/glib-2.0/schemas, to the environment variable
  77 GSETTINGS_SCHEMA_DIR.
  78
  79 Desktop Shortcuts
  80 =================
  81 After the installation is done, for Ubuntu and derivatives
  82 (e.g., Goobuntu), you can create desktop shortcuts starting Dasher in
  83 different profiles by running:
  84
  85   ./create-linux-desktop-shortcuts.sh
  86
  87 The Contributor’s Guide
  88 =======================
  89 If you would like to contribute to this project, please check out the following guide: https://docs.google.com/document/d/1qosKPV0GXbHs69PyvK9BR3S3oNgdV8il7AVfO1M4Fh4