
About Rosegarden
================

This is the Rosegarden Editor and Sequencer suite, release 2.0 beta 2.

The code contained in this directory tree was written by Chris Cannam,
Andy Green and Richard Bown, with some code from other contributors as
identified in the source files.  This version of Rosegarden is
copyright (c) 1994-1996 Chris Cannam, Andy Green and Richard Bown,
except where noted in the source.  You may redistribute it without
charge in any form you like, so long as you maintain this copyright
notice in the distribution and document any changes you make from this
version.  You may not use this code for commercial purposes without
prior written permission from the copyright holders.


About this distribution
=======================

This distribution contains binaries of Rosegarden compiled and
statically linked to run on a Sun SPARC machine with Solaris.  The
machine used to build the system was running SunOS 5.3.

See the file CAVEATS.solaris for some problems we've noted with this
distribution.


Installation
============

If you keep external applications in a common area such as
/usr/local/bin, and if you keep support code for external applications
in the neighbouring lib directory /usr/local/lib, then you can
probably install by simply extracting the distribution archive from
within the /usr/local directory.

(The directory ./bin contains the Rosegarden Top Box executable; this
is the bit you run to use the program, so must be placed somewhere in
your PATH.  The directory ./lib/rosegarden contains supporting
executables for the Editor and Sequencer, and help files; these don't
need to be accessible to anything except the Top Box, so don't need to
be in your PATH.  The directory ./lib/music contains a few sample
files.)

When the executables and help files are in suitable places, edit the
first few lines of the resource file ./Rosegarden so as to list the
right locations, and then copy this resource file to a suitable place
(your home directory, /usr/lib/X11/app-defaults, somewhere like that
-- you'll know if Rosegarden can't find this file, because it will
refuse to run).

You should then be able to run the program "rosegarden".


Absent from this release
========================

Features which we know are not in this release and which we know we
would like to add include: better primary note-entry mechanisms in the
editor (maybe a piano-keyboard window and some keyboard accelerators
or modifiers); support for patch-set modification in the sequencer,
with instruments selectable in the editor; a working Undo in the
editor; printing straight to PostScript or other printer formats;
sequencer velocity information; a status line which tracks the
position of the mouse within the piece; MIDI editing from within the
piano-roll windows; and a few other things.


Support
=======

We're doing a certain amount of maintenance and development of
Rosegarden, but we're not supporting it as such.

However, if you have any complaints, bug reports, modifications, news
of successful or unsuccessful ports to other machines, constructive
criticism, or any comment at all that doesn't necessarily require
immediate action, please email it to me.  I don't particularly want to
hear about installation problems, but if you're really desperate, go
ahead and ask.

(Bug reports are especially welcome during the beta-test period: if
you find a problem, don't just assume that we "probably already know"
about it.  We don't have enough users for that to be very likely.)


Chris Cannam, cannam@zands.demon.co.uk
July 1996
