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

This is the Rosegarden Editor and Sequencer suite.

The code contained in this directory tree was written by Chris Cannam
and Andy Green.  This version of Rosegarden is copyright (c) 1994-1995
Chris Cannam and Andy Green, except where noted in the source.  You
may redistribute it as much as you like 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.

This should probably be thought of as a beta-test of version 1.0. There
are some fairly prominent problems, most notably that the sequencer's
MIDI recording is unlikely to work at all.  And also, of course, tens
of thousands of disgraceful and virulent bugs.


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

In order to build Rosegarden you will need a UNIX box with an ANSI C
or C++ compiler and the X11, Xt and Athena Widget Set headers and
libraries from X11R5 or R6.  It should be possible to build this on
most flavours of UNIX, though it was developed for SGI IRIX 5.x
systems (ideally with the Zilog Z8530 output controller connected to a
MIDI dongle).

No Imakefile is included (I may make one later).  To build, modify the
Makefile in this directory in accordance with the location and
requirements of this build, and type "make".  (If you have to make
further modifications for system dependencies, you might consider
putting them in ./common/include/SysDeps.h .)

Neither is there any automatic installation procedure; to install,
carry out the following:

   move or copy the three executables ./bin/rosegarden, ./bin/editor
   and ./bin/sequencer to a suitable binaries directory (renaming
   them if you like -- we're not *requiring* that you call the
   editor "editor", though if I were you I'd call it that but put
   it in a Rosegarden-specific directory);

   move or copy the two help files ./common/help/rosehelp.info and
   ./common/help/rosehelp.hnx into a directory you consider suitable for
   help files (they must be both in the same directory);

   if desired, place the sample Rosegarden editor files
   ./common/music/rosegarden/*.rose and the sample MIDI data files
   ./common/music/midi/*.mid in a suitable directory of your choosing;

   modify the resource file ./Rosegarden to indicate the locations of
   the executable files and help files, and copy it to an X defaults
   directory (/usr/lib/X11/app-defaults, your home directory, somewhere
   like that).  Rosegarden will refuse to run at all if this file has not
   been placed in one of the standard X defaults file locations.  You
   may also have to modify the colours and fonts defined in
   ./Rosegarden if the supplied ones are not available on your system.

The compilation procedure has been tested using cc and NCC on SGI IRIX
5.2 and 5.3 with X11R5 and R6, and CC (cfront-based C++ compiler) and
gcc on SunOS 4.x with X11R5.


Support
=======

I'm doing a certain amount of maintenance/development of Rosegarden,
but I'm not supporting it as such.  If you have problems installing or
using it, don't mail me unless you're pretty sure it's my fault (or
unless you're really really desperate).

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.

Note that some bug report files, a to-do list and the like can be
found in ./common/dev-doc; perhaps refer to these before complaining.


Chris Cannam, cannam@zands.demon.co.uk
June 1995
