updated on Tue Jan 24 12:00:22 UTC 2012
[aur-mirror.git] / xastir-cvs / README
blobd9d86e3437560a60734e3d33651f5d3da7745c76
1 February 2011;  Mike WB2FKO   (mph@sportscliche.com)
3 This xastir-cvs PKGBUILD installs the most up-to-date (often called`bleeding edge' ) version of xastir from the CVS repositories on sourceforge.net.  Arch packaging standards require that the installation be placed in /usr/share/xastir, not /usr/local/share/xastir as stated in the xastir documentation.  There will also be a .xastir folder in the home directory.
5 Sound
6 ======
7 To enable the speech feature, you must have the festival package installed (you will also need a speaker package such as festival-en or festival-english) before building xastir.   Festival must be running before xastir is started for speech to function properly.  I was able to start it on the command line with
9 $festival --server
11 or you can write a simple script to automate the sequential starting process.  There may be problems if other programs such as a media player are accessing sound simultaneously.  The PKGBUILD automatically downloads an 850 kB bundle of .wav files located at:
13 http://downloads.sourceforge.net/xastir/xastir-sounds.tgz
15 and places them here:
17 /usr/share/xastir/sounds/
19 These are audio alarm recordings of a North American English speaker dating from 2003.  The audio play command `play' in the configure menu may not work; try `aplay' instead. 
21 Patching xastir 2.0.0 for the ABS
22 ===========================
23 As of October 2010, the most current `stable' release was xastir 2.0.0.  This was an important release because the developers migrated from defunct Tiger Maps to Open Street Maps (OSM).  xastir-2.0.0 can be built from source using the usual process of 
25 ./configure
26 make
27 sudo make install
29 It is not, however, compatible with the Arch Build System (ABS) unless the makefile is patched.  A patch is needed to fix errors in the destination directories.  Tom Russo provided a patch to accomplish this:
31 -- Makefile.am  8 Sep 2010 18:13:26 -0000       1.57
32 +++ Makefile.am 9 Nov 2010 01:48:13 -0000       1.58
33 @@ -72,10 +72,10 @@
34  # documentation is FHS compliant.
36  install-exec-hook:
37 -       -rm -rf ${pkgdatadir}/doc
38 +       -rm -rf $(DESTDIR)${pkgdatadir}/doc
40  install-data-hook:
41 -       cd $(mapdir) && \
42 +       cd $(DESTDIR)$(mapdir) && \
43         rm -f CC_OpenStreetMap.png && \
44         $(LN_S) CC_OpenStreetMap_logo.png CC_OpenStreetMap.png
46 To use the patch, create an empty file (named fixdestdir.patch here), paste in the above text, and place it somewhere in your home directory.  The patch is called with a line that is added to a standard PKGBUILD at the top of the build command:
48 patch < $path-to-patch-file/fixdestdir.patch
50 Note that this patch is NOT necessary if xastir is built from CVS.  The developers fixed the problem in a subsequent CVS release.