

Table of Contents
*****************




INSTALL - how to compile and install GNU Solfege 1.4.5 on a GNU like system
  Obtaining
  You need this
  Configuring and compiling
    `--without-gnome'
    `--disable-oss-sound'
  Packaging


INSTALL - how to compile and install GNU Solfege 1.4.5 on a GNU like system
***************************************************************************

   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/showfiles.php?group_id=1465'.

   The source code is also available from the GNU ftp sites and their
mirrors: `ftp://alpha.gnu.org/gnu/solfege' and
`ftp://ftp.gnu.org/gnu/solfege'.

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

You need this
=============

   * GNU Make

   * Gettext

   * Python header files (Python 2.1 or later)

   * C compiler (only GCC is tested, nothing else is expected to work.)

   * GNU m4 macro processor (for documentation preprocessing)

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

   * swig (Simplified Wrapper and Interface Generator) found at
     `http://www.swig.org'.

   These programs are usually included with your linux distro.

   If you edit `configure.in', you need GNU Autoconf.

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/solfege1.4

   Since Solfege require GNU m4 and GNU make, FreeBSD should do
something like this:

     M4=/usr/local/bin/gm4 ./configure
     gmake
     su -c "gmake install"

   (If you first try without setting the `M4' variable, and see
configure fail, then you have to delete the file `config.cache' before
running the example above.)

   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

   If you just want to run Solfege without installing, do this:
     ./configure
     make
     ./solfege.py

   The `configure' script can be given a number of options to enable
and disable various features. Some of them are described below.  For a
complete list, type:

     ./configure --help

`--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.

