

INSTALL - how to install the development releases of GNU Solfege
****************************************************************

   This file contains info on how to build and install GNU Solfege.
For run-time info, check the README file and the man page.

Obtaining
=========

   The latest version is available from
`http://download.sourceforge.net/solfege' or (same server, other look)
`http://sourceforge.net/project/filelist.php?group_id=1465'.

   * Unstable source: `ftp://alpha.gnu.org/gnu/solfege'.

   * Stable source:`ftp://ftp.gnu.org/gnu/solfege'.

   The homepage for GNU Solfege is `http://www.solfege.org'.

Configuring and compiling
=========================

     ./configure
     make
     su -c "make install"

   should work, and will install into

       /usr/local/bin
       /usr/local/share
       /usr/local/lib
       /etc/gnome/config/solfege1.0    (/etc/solfege1.0 if you are running a version built without GNOME)

   Use the `--prefix' and `--sysconfdir' command line options to
install elsewhere. For example to install in your home directory:

     ./configure --prefix=$HOME/usr --sysconfdir=$HOME/etc
     make
     make install

`--without-gnome'
-----------------

   You can build Solfege without using the gnome libraries if you give
`configure' the `--without-gnome' command line option.

   This is a ugly stripped down version of Solfege without html support
and without the id-tone exercise and piano and guitar widgets.

`--disable-oss-sound'
---------------------

   Use this if you are compiling on an OS that dont have the OSS.  The
default is `--enable-oss-sound'.

Packaging
=========

   To create a debian package, configure and type `make deb'.

   To create rpm and src.rpm package, configure and type `make rpm'.
You need write access to `/usr/src/redhat' to do this.

For compiling you need:
=======================

   * GNU Make

   * Python header files

   * C compiler (only GCC is tested)

   * m4 macro processor (for documentation preprocessing)

   * texinfo (ftp://ftp.gnu.org/gnu/texinfo)

For development
===============

   If you make any changes to the C code in `soundcard/', you'll need
   * swig (Simplified Wrapper and Interface Generator) found at
     `http://www.swig.org'.

