README

   1 Dasher Version 4.11
   2 -------------------
   3 Dasher is a zooming predictive text entry system, designed for situations
   4 where keyboard input is impractical (for instance, accessibility or PDAs). It
   5 is usable with highly limited amounts of physical input while still allowing
   6 high rates of text entry.
   7
   8 Dasher is Free software released under the GPL. Further documentation
   9 may be found in the Doc/ subdirectory
  10
  11 Requirements
  12 ------------
  13 Dasher makes use of the following third party software (note that this
  14 list is potentially inaccurate or incomplete - please send any
  15 corrections to 'dasherteam@yahoogroups.com):
  16
  17 General:
  18  * The Expat XML parser (required)
  19
  20 Linux (see INSTALL.Linux for build time requirements):
  21  * GTK+ (2.6 or greater) (required)
  22  * GNOME (optional, but highly recommended)
  23  * Libcanna (optional, for Hiragana to Kanji conversion)
  24
  25 MS Windows:
  26  * MS Speech API (optional)
  27  * MS Table API (optional - required for tablet start/stop mode)
  28
  29 MS Windows CE:
  30  * (not sure - if anyone knows then please fill this in)
  31
  32 Platform Specific Notes
  33 -----------------------
  34 * Solaris: Dasher has been tested on Solaris 10. You will need to
  35 upgrade to gnome-doc-utils 0.3.2 to install the documentation, which
  36 in turn will require libxml 2.6.12 and libxslt 1.1.8. These packages
  37 are not required to run dasher once it is built.
  38
  39 There have been some issues with the gthread-2.0 pkgconfig file
  40 including compiler flags which are not understood by the compiler. You
  41 may need to shadow this file in another directory with these flags
  42 removed.
  43
  44 GNU make (gmake) must be used if building gnome documentation.
  45
  46 * Darwin / OS-X: The native UI in the macos directory is badly out of
  47 date and will almost definitely require considerable effort to
  48 build. We do not currently have the resources to maintain this port,
  49 but if you are interested in contributing then let us know
  50 (dasher@inf.phy.cam.ac.uk). The GTK2 front end should build on Darwin
  51 with minimal changes, and with a recent enough version of GTK will not
  52 require the X11 server.
  53
  54 Installation Instructions
  55 -------------------------
  56 Please see the file INSTALL.<platform> for details on how to build and
  57 install Dasher from source on your host system.
  58
  59 Font Support
  60 ------------
  61 Dasher includes some alphabets which require fonts that you probably don't
  62 have installed; for example, for the International Phonetic Alphabet, Korean
  63 and Hiragana (Japanese).  We aren't legally allowed to distribute a font for
  64 the IPA, but you can download one yourself from:
  65
  66    http://www.sil.org/computing/fonts/encore-ipa.html
  67
  68 Kanji Entry
  69 -----------
  70
  71 As of Dasher 3.99.0, experimental support for Japanese Kanji entry
  72 by Hiragana conversion. To build Dasher with this enabled on Linux,
  73 you need the libcanna conversion library. You also need to be able to
  74 access a canna conversion server, which can be on the local machine or
  75 over a network. Please note that Dasher will not start a canna server
  76 if none is running - you must do so manually before running Dasher.
  77 Please see the Canna documentation for more details.
  78
  79 Kanji conversion in Microsoft Windows is via the IME API, which is
  80 part of Windows XP and Asian builds of earlier Windows
  81 versions. Support for Kanji conversion in Dasher under Windows is
  82 still very much under development, so please take care when trying
  83 it out. In particular, Dasher will crash if you try to enable Kanji
  84 conversion on a machine which does not have Japanese localisation
  85 installed.
  86
  87 To use Kanji conversion in Dasher, you must select 'Japanese Canna'
  88 from the 'Alphabet' section of the preferences dialogue, and the
  89 Japanese language model from the 'Prediction' section.
  90
  91 Support and Feedback
  92 --------------------
  93 Please file any bug reports in the GNOME Bugzilla system:
  94
  95 http://bugzilla.gnome.org/
  96
  97 using the 'dasher' package name. We also appreciate general feedback -
  98 please send any comments to 'dasher@inf.phy.cam.ac.uk'.
  99
 100 You can find the Dasher website at:
 101
 102   http://www.inference.phy.cam.ac.uk/dasher/
 103
 104 Thank you for trying Dasher,
 105
 106 The Dasher Team
 107