README.OpenBSD
author Sam Lantinga <slouken@libsdl.org>
Tue, 05 Mar 2002 19:55:32 +0000
changeset 292 eadc0746dfaf
parent 37 3ad7157c6cfa
permissions -rw-r--r--
Added SDL_LockRect() and SDL_UnlockRect()
Incorporated XFree86 extension libraries into the source
slouken@37
     1
=============================================================
slouken@37
     2
Using the Simple DirectMedia Layer with OpenBSD 2.9 and later
slouken@37
     3
=============================================================
slouken@37
     4
slouken@37
     5
Author: 
slouken@37
     6
Peter Valchev <pvalchev@openbsd.org>
slouken@37
     7
  
slouken@37
     8
=======
slouken@37
     9
Install 
slouken@37
    10
=======
slouken@37
    11
There is an OpenBSD port for SDL and various other tools.  Using
slouken@37
    12
this port is recommended, since it contains all the needed patches
slouken@37
    13
and configure arguments nicely organized in several FLAVORS you
slouken@37
    14
can pick from.  If you're unfamiliar with the OpenBSD ports system
slouken@37
    15
please visit:
slouken@37
    16
http://www.openbsd.org/ports.html
slouken@37
    17
http://www.openbsd.org/anoncvs.html
slouken@37
    18
slouken@37
    19
You should have a precompiled binary package on your OpenBSD 2.9
slouken@37
    20
or later CD-ROM, which you can easily add with pkg_add(1).
slouken@37
    21
slouken@37
    22
If for whatever reason you're unable to take the advantage of the
slouken@37
    23
created port, or you want to stick with the newest fresh SDL from
slouken@37
    24
the current CVS repository, here are some hints of what has left
slouken@37
    25
unresolved and needs to be disabled/changed.
slouken@37
    26
slouken@37
    27
To build SDL with OSS + esound:
slouken@37
    28
slouken@37
    29
1. ./configure --disable-joystick \
slouken@37
    30
	--disable-pthread-sem \
slouken@37
    31
	--disable-nasm \
slouken@37
    32
	--enable-esd \
slouken@37
    33
	--enable-oss \
slouken@37
    34
	--disable-arts \
slouken@37
    35
	--disable-video-opengl
slouken@37
    36
slouken@37
    37
OR
slouken@37
    38
slouken@37
    39
To build SDL with native audio + esound (remove --disable-esd otherwise):
slouken@37
    40
1. ./configure --disable-joystick \
slouken@37
    41
	--disable-pthread-sem \
slouken@37
    42
	--disable-nasm \
slouken@37
    43
	--enable-openbsdaudio \
slouken@37
    44
	--enable-esd \
slouken@37
    45
	--disable-arts \
slouken@37
    46
	--disable-video-opengl
slouken@37
    47
slouken@37
    48
If you need arts or GL, omit the responding --disable lines.  In the
slouken@37
    49
port, they're disabled by default, you need to specify flavors to
slouken@37
    50
make use of them.
slouken@37
    51
slouken@37
    52
2. gmake    # Yeah, GNU make is required, install the package 
slouken@37
    53
3. sudo gmake install
slouken@37
    54
slouken@37
    55
=========
slouken@37
    56
Todo List 
slouken@37
    57
=========
slouken@37
    58
slouken@37
    59
Feedback is always welcome with anything you may find useful and
slouken@37
    60
you can suggest.
slouken@37
    61
For now, the following things have to be worked on:
slouken@37
    62
slouken@37
    63
1. The native audio should be widely tested and will eventually
slouken@37
    64
become the default.  At that moment I have not received any 
slouken@37
    65
feedback which should explain its current condition.
slouken@37
    66
slouken@37
    67
2. There are occurences of dynamic loading of drivers in the OpenGL
slouken@37
    68
code section, and our a.out architectures need an underscore prefixed
slouken@37
    69
to symbol names.  Some solution to that may be a good thing.  I can
slouken@37
    70
fix it theoretically, but unfortunately I do not have the needed 
slouken@37
    71
hardware/configuration to test it.  If you bump into that, email me.
slouken@37
    72
slouken@37
    73
===================
slouken@37
    74
Contact Information
slouken@37
    75
===================
slouken@37
    76
Everybody is welcome to give me any suggestions and to report bugs
slouken@37
    77
(as well as fixing them ;-)  You can contact me by email:
slouken@37
    78
Peter Valchev <pvalchev@openbsd.org>
slouken@37
    79
slouken@37
    80
$Id$
slouken@37
    81