SDLmm - Simple DirectMedia Layer glue for C++
		      http://sdlmm.sourceforge.net/

SDLmm is a C++ glue for SDL, or the Simple DirectMedia Layer, which is
a generic API that provides low level access to audio, keyboard,
mouse, joystick, 3D hardware via OpenGL, and 2D framebuffer across
multiple platforms.

SDLmm aims to stay as close as possible to the C API while taking
advantage of native C++ features like object orientation. We will also
aim at being platform independent as much as possible. I.e we'll try
to support ever platform supported by SDL.

This library is, like SDL, distributed under GNU LGPL version 2
license, which can be found in the file "COPYING".  This license
allows you to use SDLmm freely in commercial programs as long as you
link with the dynamic library.

SDLmm will be documented well (latest docs will always be available
from the project website), but you might will still want to read the
documentation for SDL (see the SDL documentation project at
http://sdldoc.csn.ul.ie/).

For a more complete list of goals and projected work order, see the
file GOALS.

The test programs in the "test" subdirectory are in the public domain
and will mostly be ports of the SDL test programs. It's possible the
documentation will also include annotated versions of these test
programs.

	-- David Hedbor <david@hedbor.org>

SDLmm is not yet compiled on BeOS, but it should be as simple as
configure + make. When I get time, I'll try it out.

SDLmm is not yet compiled on MacOS or MacOS X. I don't access to any
Mac development system.

If you are interested in maintaining a MacOS port, let us know.

Not compiled yet. Will try to compile when time permits.

	Compiling SDLmm on for Win32 using VisualC++ 6.0
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

I have successfully cross compiled SDLmm using VisualC++ 6.0 on a
Windows system. In the 'VisualC' subdirectory you should find the
'sdlmm.dsp', 'libsdlmm.dsp'  and 'sdlmm.dsw' files reqiured for
compiling. These files generate a static library (libSDLmm.lib)
and a DLL (SDLmm.DLL, SDLmm.lib). You will need to update the
include path to point to where you have installed SDL.

Once this has built you can try the test programs in the
'test\VisualC' subdirectory. Again you will need to update the
include path to point to where you have installed SDL. Also you will
need to update the library path to find the 'SDL.lib' and
'SDLmain.lib' files.

Note that with these makefiles the release version is compiled with
the multithreaded c-runtime DLL and the debug version is
compiled with the multithreaded debug c-runtime DLL. The debug
version also has a 'd' appended to the name so that they can both
exist in the same directory.


	Compiling SDLmm on for Win32 using mingw32 (deprecated)
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

I have successfully cross compiled SDLmm using mingw32 on a Linux
system. You can download the required packages from the SDL website:

		http://www.libsdl.org/Xmingw32/

After installing the compiler, and required libraries (including SDL
which you can download from http://www.libsdl.org/download-1.2.html),
you run cross-configure.sh (downloaded from the above page) followed
by cross-make.sh. You can also generate the test programs with
cross-make.sh test.

At this point, only a static library will be generated (SDLmm.a). The
dynamic library generation fails due to (I believe) unresolved
symbols. This will hopefull be resolved as SDLmm matures.

*** This currently doesn't work correctly. If you can fix the above
*** dynamic library problem, please contact us.

Compiling SDLmm from CVS:
-=-=-=-=-=-=-=-=-=-=-=-=-

It's easy to compile SDLmm from CVS. Just run the ./autogen.sh script
before following the normal installation instructions. Please note
that this step requires the autoconf and automake packages.

To get SDLmm from CVS:
-=-=-=-=-=-=--=-=-=-=-

To checkout the current development version of SDLmm from CVS, follow these
commands:

cvs -d:pserver:anonymous@cvs.sdlmm.sourceforge.net:/cvsroot/sdlmm login
[Hit [Return] as the password (ie empty password)]

cvs -z3 -d:pserver:anonymous@cvs.sdlmm.sourceforge.net:/cvsroot/sdlmm co -P SDLmm

You can later update your SDLmm source from CVS by typing:

cvs -z3 update -Pd

with the current directory being the "SDLmm" directory you got from
the initial checkout.

For more detailed information on CVS access, including read/write
developer access and access to other (stable) branches, visit the web
page at

Example build process
-=-=-=-=-=-=-=-=-=-=-=-=-

: 2 neotron@stellar ./autogen.sh
Now you can run ./configure.
: 0 neotron@stellar ./configure
[configure output]
: 0 neotron@stellar make
[make output]
: 0 neotron@stellar make install
[install output]