1 INSTALL.win32 - how to install GNU Solfege 2.1.7 on MS Windows
****************************************************************

Installing Solfege 2.1.7 on MS Windows is almost as simple as on Debian
GNU/Linux:

   * Download the file solfege-win32-2.1.7.exe available through the
     website as `http://www.solfege.org'.

   * Run the file by double-clicking on it.

   * Accept all default values, and the program is installed in a few
     seconds.

   * You can start the program from the Start Menu, select Programs/GNU
     Solfege.

1.1 Uninstall the program.
==========================

To uninstall the program, use the 'Add/remove program' utility in the
control panel.  Do not delete the files directly.

1.2 Trouble?
============

It is possible that the file `\home\.solfegerc2.1' is corrupted by a
bug in the program. If you have strange problems, you can try to delete
the file and rerun the program.

   If you still have problems, you should check if there is a newer
release available. And if so, test that release to see if the bug has
been fixed. If not, you can email you can email your questions to
<solfege-devel@lists.sourceforge.net>. Remember to tell what version of
Solfege you are running, what version of MS Windows, and the name of
the soundcard, if you know it. Do _not_ email the author of Solfege
directly, because when emailing the list, other people than me get the
chance to help.

1.3 Developers
==============

*** This section is under construction. Missing and wrong urls and
version numbers and plain lies follows: ***

   This section will be filled with info for developers that has to use
MS Windows while programming.

   There are some stuff you need to have installed:
   * Python 2.2 (http://www.python.org/2.2).

   * py2exe

   * Inno Setup (http://www.jrsoftware.org/isinfo.php)

   * gtk+ 2.0 for win32 from http://www.dropline.net/gtk/

   * pygtk for win32 from
     http://www.mapr.ucl.ac.be/~gustin/win32_ports/pygtk.html

   * GnuWin32 zlib: gnuwin32.sf.net. Use the -bin installer

   * Wimp-theme, from sourceforge. This is optional, but make the
     program look more like a native win32 app.

   At the moment, building the installer is done this way:

   * On Linux: from the source dir: `make export-to-dos'

   * Copy the newly create directory `../solfege-export-to-dos'   to
     your windows partion.

   * Reboot to some version of Windows

   * Edit runpy2exe.bat so that PYTHONPATH points to where gtk+ and
     zlib is installed.

   * Windows: run the runpy2exe.bat

   * Double-click the file 'windowsinstaller and select "Compile NSI"

   Hopefully, I or someone else will figure out how to build the sound
module on windows instead of cross-compiling it from linux. Then it
will be possible to do the whole build of the windows installer on
windows.

   Newer or older versions of gtk and pygtk might work, but don't come
screaming for help if they break. (But please do if the above urls
disappear.)

   Sometimes windows can have trouble finding/loading some of the
gtk.dll's, it usually works if you try to start the program a few times
more.

1.4 Sound
=========

The first port to MS Windows had to call an external midiplayer program
to play the music, but thanks to Joe Lee, Solfege now talks directly to
the soundcard, just like on linux. Using `midiplayer.exe' is still
possible, but talking directly to the soundcard is now the default.
(`midiplayer.exe' will disappear in a later version if nobody needs it.)

   Please let me know if you have any problems with this new sound
code, and especially if using `midiplayer.exe' works and winsynth fails.

