From 0490296a9bd979454042d0bc64f1f2c4c724a674 Mon Sep 17 00:00:00 2001
From: "Tim E. Real" <termtech@rogers.com>
Date: Tue, 19 Oct 2010 06:39:46 +0000
Subject: See ChangeLog

---
 muse2/README | 121 +++++++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 84 insertions(+), 37 deletions(-)

(limited to 'muse2/README')

diff --git a/muse2/README b/muse2/README
index 65963b43..b0e19086 100644
--- a/muse2/README
+++ b/muse2/README
@@ -1,5 +1,5 @@
 ====================================================================
-      MusE  ---  Linux (Midi) Music Editor
+      MusE  ---  Linux Music Editor
 ====================================================================
 
 Welcome to MusE, the open source MIDI/Audio sequencer.
@@ -19,64 +19,111 @@ details.
   =============================
       Requirements
   =============================
+      
 
-      - QT: Qt 3.2.0 or above
+      - CMake >= 2.4 
+        http:/www.cmake.org/HTML/Download.html
+
+      - QT: Qt >= 4.2.0 
         ftp://ftp.trolltech.com/qt/source
         MusE does _not_ compile with older versions
-        Please compile Qt3 with "-thread" option so you get
-        the qt-mt.so lib instead of qt.so
-        MAKE SURE YOU SET YOUR 'QTDIR' ENVIRONMENT VARIABLE
-
-      - ALSA 0.9.x or newer (cvs)
-        http://www.alsa-project.org/
 
-      - gcc 3.x.x
-        NOTE: you _must_ compile MusE with the same compiler
-                you used to compile QT
+      - gcc >= 4.x.x
 
-      - libsndfile 1.0.1 (current 1.0.4)
+      - libsndfile >= 1.0.1
         http://www.zip.com.au/~erikd/libsndfile/
 
-      - Linux kernel with rtc (RealTimeClock) driver (device /dev/rtc)
-        (you may also apply "low latency patches" for low timing jitter)
+      - libsamplerate
+
+      - JACK >= 0.103
+          http://jackit.sourceforge.net/download/
 
-      - JACK
-	  http://jackit.sourceforge.net/download/
+      Optional:
 
-      - fluidsynth-1.0.3 (formerly known as iiwusynth) from
+      - fluidsynth >= 1.0.3 (formerly known as iiwusynth) from
         http://savannah.nongnu.org/download/fluid
 
-      - of course: a soundcard and/or some midi gear
-      - (if you compile from cvs:) automake 1.7 and autoconf 2.54
+      - OSC (Open Sound Control) 
+      - DSSI (Disposable Soft Synth Interface) with support for DSSI vst plugins.
+        (Both recommended - DSSI alone will have no DSSI GUIs. OSC alone does nothing, for now.)
+
+      - LASH Audio Session Handler
+      
+      - ConTeXt (for building documentation, by default the build
+               script tries to build documentation, can be
+               disabled by setting ENABLE_DOCUMENTATION to OFF)
 
   =============================
       Compiling:
   =============================
 
       - download source from http://lmuse.sourceforge.net/
-      - uncompress source:
-            bunzip2 muse-x.x.x.tar.bz2
-      - untar source:
-            tar xvof muse-x.x.x.tar </code>
-        or if you have a recent tar, you can combine both steps:
-            tar xvofj muse-x.x.x.tar.bz2
-
-      - enter dirctory muse-x.x.x:
-            MAKE SURE YOU SET YOUR 'QTDIR' ENVIRONMENT VARIABLE
-            run configure
-            run make all
-
-      - as root run:
-            make install
-        to install MusE
+
+      - command line to unpack source:
+            tar xvofz muse-x.y.z.tar.gz </code>
+        where x.y.z is the version number.
+
+      - to compile MusE, run the following commands from the 
+        top level directory, where the source code was unpacked : 
+        
+            mkdir build                                      # create build directory
+            cd build                                         # enter build directory
+            
+            cmake  [-DCMAKE_INSTALL_PREFIX=<prefix> ] ../    # create make system in build directory
+                                                             # prefix is desired location to install MusE, default /usr/local
+            
+            make                                             # compile muse
+            
+      - install MusE:
+            run "make install"  (as root user)
+
+  =============================
+      running MusE
+  =============================
+
+      MusE is a realtime program which requires special rights to
+      work poperly.
+      Recommended setup:
+
+      - check if you are running a sufficiently new linux kernel > 2.6.x
+
+      - create an "audio" group if it does not already exists
+        and put yourself into this group
+
+      - make sure you can acces the realtime clock (RTC)
+            chmod 660 /dev/rtc
+            chgrp audio /dev/rtc
+
+      - make sure MusE can set the rtc clock:
+            echo 8192 > /proc/sys/dev/rtc/max-user-freq
+            inspect with:
+            cat /proc/sys/dev/rtc/max-user-freq
+
+      - for MusE to gain RT priviledges load the "realtime-lsm"
+        modul; the modul should be configured to give all "audio"
+        group members realtime priviledges
+
+      - some distros do not load the alsa sequencer module by default.
+        if necessary, load the alsa sequencer module with:
+            /sbin/modprobe snd-seq
+
+      - start qjackctl
+            - start JACK with qjackctl
+
+      - start MusE
+
+      (JACK and all its clients (qjackctl & MusE) must run with the
+      same user id)
+
 
   =============================
-      some known bugs
+      known bugs
   =============================
 
       - many
 
 ====================================================================
-Let me know whether MusE works for you !!!
-Have a look at the webpage http://www.muse-sequencer.org/ for details.
+Let us know whether MusE works for you !!!
+Have a look at the webpage http://www.muse-sequencer.org for details.
+
 
-- 
cgit v1.2.3