                 RoarAudio
             As loud as a Lion
           ---------------------

--- What is RoarAudio?:

RoarAudio is a cross-platform sound system for both, home and professional use.
It can be used to mix audio for output on a single-stream soundcard or to play
audio over the network.

For more Information see our website at:
http://roaraudio.keep-cool.org/

--- Build:

-- Build requirements:

A POSIX system or win32.

You should install libesd and libao and maybe some codecs.
For Debian you may use this command:
 $ apt-get install build-essential libdnet-dev libesd0-dev libao-dev libvorbis-dev libspeex-dev libspeexdsp-dev libshout3-dev liboggz2-dev libslp-dev libx11-dev

Note that in case you want to use any emulation you need to install the corresponding
sound system on the build system as we are using headers and other files from those
sound systems to be most compatible. You can safely uninstall them after building
RoarAudio has been completed.

The following binarys are suggested to be installed, too:
 gnupg, openssh-client, socat, wget

Also you maybe want to install Roar and RoarD (on debian libmuroar* and muroard).

-- How to build:

 $ ./configure
 $ make

In order to build win32 binarys on UNIX or GNU/Linux:
 $ CC=...mingw32...gcc ./configure --target-win32
 $ make

In order to build win32 binarys on Win32 with MinGW/MSYS:
 $ bash configure
 $ make

Building on OpenVMS:
 Ask on the RoarAudio Mailinglist.

--- Plugins:

Plugins should be build automaticly since 0.2rc2.

--- Writing software for RoarAudio:

See manpages: libroar(7) and roartut(7).
You also should read the example code in roarclients/*.c

--- Writing patches for this packet:

See HACKING.

--- Want to be a maintainer for your favorite OS?:

See HACKING.

--- Tested platforms:

OPERATING SYSTEM	ARCH	COMPILER	TESTED		M/STATUS	COMMENT
AND VERSION					VERSION
---------------------------------------------------------------------------------------------------
Debian Etch		ix86	gcc 4.1.2	current		s/OK
Debian Etch		x86_64	gcc 4.1.2	1.0b9p1		s/OK
Debian Lenny		ix86	gcc 4.3.2	1.0b2		s/OK
Debian Lenny		x86_64	gcc 4.3.2	0.4b2		s/OK		No speex (why?)
Debian ?		x86_64	gcc 4.3.4	0.3b3		m/OK
Debian Squeeze		*	*		0.3		M/OK
Debian Wheezy		x86_64	gcc 4.7.2	1.0b11		s/OK
Debian Sid		ix86	gcc ?		1.0b2		M/OK
Debian Sid		ix86	clang 2.7	0.4b4		s/WIP		Use --no-fishsound. roard broken. Why?
Debian Sid		*	*		*		M/OK
Debian Sid		x86_64	gcc 4.7.1	1.0b7		M/OK
Debian Sid		x86_64	gcc 4.7.2	1.0b9p1		M/OK
Ubuntu 9.04		ix86	gcc 4.3.3	0.2rc2		s/OK
archlinux ?		i686	gcc 4.3.2	0.4rc0		M/OK
Gentoo 1.12.11.1	i686	gcc 4.3.2-r3	0.3b0		s/OK
NetBSD 1.6.1		Alpha	gcc 2.95.3	0.3b7		s/OK		gcc too old,
										does not support debug macros
NetBSD 4.0		i386	gcc 4.1.2	0.2		s/OK		need to use --roard-cfreq 20
NetBSD 5		x86_64	gcc 4.1.3	0.2b?		s/?
OpenBSD ?		x86_64	gcc ?		0.2rc2		s/OK
OpenBSD 4.4		i386	gcc 3.3.5	1.0b11		s/OK
OpenBSD 4.5		i386	gcc 3.3.5	0.2rc2		s/OK
OpenBSD 5.0		x86_64	gcc 4.2.1	1.0b9p1
OpenVMS V8.3		Alpha	HP C V7.3-009	0.4b1		s/WIP		Work in process. Ask on ML.
FreeBSD 6.2		i386	gcc 3.4.6	0.1b4		s/OK
FreeBSD 7.1		i386	gcc 4.2.1	0.2		s/OK
FreeBSD 7.2		i386	gcc 4.2.1	0.4b0		s/OK
FreeBSD 7.3		i386	gcc 4.2.1	1.0b0		s/OK
FreeBSD 7.4		i386	gcc 4.2.1	1.0b9p0		s/OK
OpenSolaris 5.11	i386	gcc 3.4.3	?		s/OK
Darwin 9.4.0		i386	gcc 4.0.1	0.1b?		s/OK
Cygwin 1.5.25		i686	gcc 3.4.4	0.3b6		s/Client+	Client libs work, roard only partly,
										Problems with libroaross,
										need to be disabled.
										Hostsystem: WinXP Home
WinXP Home		ix86	mingw 3.4.5	0.3		s/Client+	Some Clients work, roard only partly
										was build on Debian Etch
Wine 0.9.25		ix86	mingw 3.4.5	1.0b9p0		s/Client+	Some Clients work, roard only partly
										Hostsystem: Debian Etch
WinXP/MSys		ix86	mingw 4.7.0	1.0b11		m/OK		Automatic Build Bot.

Tested Version:
	Current:	Current as listed on Homepage
	last:		Last released version (This system is on release checklist)
	*b*:		Beta
	*p*		Pre-Release

Status: Maintenance/testing Status:
Maintenance:	s = your are on your own, sources.
		m = package in work, beta package
		M = maintained
		S = maintained source package
		B = maintained binary package
