=============================================================
Using the Simple DirectMedia Layer with OpenBSD 2.9 and later
=============================================================

Author: 
Peter Valchev <pvalchev@openbsd.org>
  
=======
Install 
=======
There is an OpenBSD port for SDL and various other tools.  Using
this port is recommended, since it contains all the needed patches
and configure arguments nicely organized in several FLAVORS you
can pick from.  If you're unfamiliar with the OpenBSD ports system
please visit:
http://www.openbsd.org/ports.html
http://www.openbsd.org/anoncvs.html

You should have a precompiled binary package on your OpenBSD 2.9
or later CD-ROM, which you can easily add with pkg_add(1).

If for whatever reason you're unable to take the advantage of the
created port, or you want to stick with the newest fresh SDL from
the current CVS repository, here are some hints of what has left
unresolved and needs to be disabled/changed.

To build SDL with OSS + esound:

1. ./configure --disable-joystick \
	--disable-pthread-sem \
	--disable-nasm \
	--enable-esd \
	--enable-oss \
	--disable-arts \
	--disable-video-opengl

OR

To build SDL with native audio + esound (remove --disable-esd otherwise):
1. ./configure --disable-joystick \
	--disable-pthread-sem \
	--disable-nasm \
	--enable-openbsdaudio \
	--enable-esd \
	--disable-arts \
	--disable-video-opengl

If you need arts or GL, omit the responding --disable lines.  In the
port, they're disabled by default, you need to specify flavors to
make use of them.

2. gmake    # Yeah, GNU make is required, install the package 
3. sudo gmake install

=========
Todo List 
=========

Feedback is always welcome with anything you may find useful and
you can suggest.
For now, the following things have to be worked on:

1. The native audio should be widely tested and will eventually
become the default.  At that moment I have not received any 
feedback which should explain its current condition.

2. There are occurences of dynamic loading of drivers in the OpenGL
code section, and our a.out architectures need an underscore prefixed
to symbol names.  Some solution to that may be a good thing.  I can
fix it theoretically, but unfortunately I do not have the needed 
hardware/configuration to test it.  If you bump into that, email me.

===================
Contact Information
===================
Everybody is welcome to give me any suggestions and to report bugs
(as well as fixing them ;-)  You can contact me by email:
Peter Valchev <pvalchev@openbsd.org>

$Id: README.OpenBSD,v 1.1 2001/05/26 16:58:37 hercules Exp $

