==============================================================================
LIBOSS
==============================================================================

LibOSS is a compatibility layer for MacOS X that eases porting software that
uses Linux's OSS API.


------------------------------------------------------------------------------
About This Release
------------------------------------------------------------------------------

This is our initial release, and as such, is a bit spartan.  The goal for
0.0.1 was to be able to get audio from aRts (the audio API used by the KDE
desktop environment).  This initial reference release has been built to talk
through esound, a sound server for UNIX-like systems that has native
CoreAudio support.

Future releases will be geared towards cleaning up the code and adding
CoreAudio and perhaps even pure Darwin audio support.


------------------------------------------------------------------------------
Installing LibOSS
------------------------------------------------------------------------------

The standard "./configure; make; make install" should work fine if you have
esound and libdl (dlcompat) somewhere accessible.

If you don't, see the following:

 http://www.tux.org/~ricdude/EsounD.html
 http://sourceforge.net/project/showfiles.php?group_id=17203&release_id=113418


------------------------------------------------------------------------------
Using And Developing With LibOSS
------------------------------------------------------------------------------

In theory, software that can build against Linux's OSS API should work just
fine, but you may need to do some tweaking to make it work.  LibOSS has to
do some trickery with defines to override your system's open(), write(), and
so on.  In the future we plan on providing a pkgconfig setup for liboss that
will automate some of this work, but for now, if you have questions, try
the IRC channel, or send a message to the discussion list.


------------------------------------------------------------------------------
For More Information
------------------------------------------------------------------------------

The website is at http://liboss.sf.net/ -- information on downloading, pulling
source from CVS, and other resources including mailing lists are available
there.

You can also catch us on #liboss on the FreeNode (formerly OpenProjects) IRC
network.


------------------------------------------------------------------------------
For Less Information
------------------------------------------------------------------------------

See here: http://www.gnu.org/software/less/





$Id: README,v 1.5 2002/10/22 20:13:23 rangerrick Exp $
