
Install
-------

1. Unpack the zipfile to C:\ so that this file is placed here:
   c:\snd-rt-win\readme.txt

2. If you want to install in a different directory than C:,
   you need to manually edit the following files:

     .emacs
     msys/1.0/bin/start-guile.bat
     msys/1.0/etc/fstab

   Its very easy. Just change "C:\", "C:\\" or "C:/" to the installation
   directory you are using. Make sure you use backslash where
   backslash is required, double-backslash where double-backslash
   is required, and slash where slash is required.

3. Configure qjackctl/jackdmp:

   a) Double click the "Shortcut to qjackctl.exe" icon.
   b) Click "Setup"
   c) Set Settings->Server->Server Path to "jackdmp -S"
   d) Set Settings->Server->Driver to "portaudio"
   e) Check Settings->Parameters->Realtime

   This will make jackdmp work good enough (at least thats my experience).

   Later you might want to finetune parameters. To do that,
   start the windows console (the msys terminal doesn't display console output),
   cd into msys/1.0/home/YoruAmen/jackdmp_0.67/bin/windows
   and run jackdmp.exe manually. To list options run:

      jackdmp --help

   and

      jackdmp -d portaudio --help


4. Copy .emacs to C:\.emacs

   In case you already have C:\.emacs, and you don't want to overwrite it, just
   append the contents of snd-rt-win/.emacs to the end of C:\.emacs .



Quick start
-----------

1. Start jackdmp. You do that by double clicking the "Shortcut to qjackctl.exe" icon and
   press "Start".

2. Start emacs. You do that by double clicking the "Shortcut to runemacs.exe" icon.
   I also use to maximize emacs after starting it.

3. Load snd-rt-win/msys/1.0/home/YoruAmen/snd-9.4-nongtk/rt-examples.scm
   into emacs.

4. Split your emacs window in two parts: C-x 2 [1]

5. Move the cursor to lower part window: C-x o

6. Run snd-ls: M-x run-scheme [2]

7. Move the cursor to the upper part window again: C-x o

8. Evaluate blocks of code by placing the cursor inside a block and press Ctrl+Alt+x

9. Thats it. Now you should have sound and a convenient programming environment.

   Another file to look for snd-rt examples is rt-clm-ins.scm.

   A manual for snd-rt is found here: http://www.notam02.no/arkiv/doc/snd-rt/



[1] "c-x 2" means:
      a) Press Ctrl and x
      b) Release
      c) Press 2
      d) Release

[2] "M-x run-scheme" means:
      a) Press Esc
      b) Release
      c) Press x
      d) Release
      e) Write run-scheme
      f) Press return
      g) Release
