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