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 libshout3-dev liboggz1-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

--- 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	last	s/OK
Debian Lenny		ix86	gcc 4.3.2	last	s/OK
Debian Lenny		x86_64	gcc 4.3.2	0.4b0	s/OK		No speex (why?)
Debian ?		x86_64	gcc 4.3.4	0.3b3	m/OK
Debian (sid)		*	*		last	M/OK
Ubuntu 9.04		ix86	gcc 4.3.3	0.2rc2	s/OK
archlinux ?		i686	gcc 4.3.2	0.2rc2	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	0.4b0	s/OK
OpenBSD	4.5		i386	gcc 3.3.5	0.2rc2	s/OK
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
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	0.3b6	s/Client+	Some Clients work, roard only partly
									Hostsystem: Debian Etch

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