diff options
Diffstat (limited to 'www/README.txt')
-rw-r--r-- | www/README.txt | 176 |
1 files changed, 0 insertions, 176 deletions
diff --git a/www/README.txt b/www/README.txt deleted file mode 100644 index 2f16ff6..0000000 --- a/www/README.txt +++ /dev/null @@ -1,176 +0,0 @@ -/** -* Copyright (c) 2003 Sun Microsystems, Inc. All Rights Reserved. -* -* Redistribution and use in source and binary forms, with or without -* modification, are permitted provided that the following conditions are met: -* -* -Redistribution of source code must retain the above copyright notice, -* this list of conditions and the following disclaimer. -* -* -Redistribution in binary form must reproduce the above copyright notice, -* this list of conditions and the following disclaimer in the documentation -* and/or other materials provided with the distribution. -* -* Neither the name of Sun Microsystems, Inc. or the names of contributors may -* be used to endorse or promote products derived from this software without -* specific prior written permission. -* -* This software is provided "AS IS," without a warranty of any kind. -* ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING -* ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR -* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN") AND ITS -* LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A -* RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. -* IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT -* OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR -* PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, -* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS -* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. -* -* You acknowledge that this software is not designed or intended for use in the -* design, construction, operation or maintenance of any nuclear facility. -*/ - -Project: net.java.games.joal.* & net.java.games.sound3d.* -Purpose Open Source Java Bindings for OpenAL and Object-Oriented 3D sound toolkit -Author: - -- JOAL/Sound3D API Original Author - Athomas Goldberg - Wildcard - Java Games Initiative - Software Advanced Technologies Group, - Sun Microsystems - -- This file updated 08/19/2003 by Ole Arndt <ole at sugarshark dot com> - -- This file updated 11/23/2003 by Gregory Pierce <gpierce@gregorypierce.com> -Introduction: -============= - -This is the source tree for the Java Game Initiative (JGI) Open Source -client game programming APIs for OpenAL and Sound3D. - - -Build Requirements: -=================== - -This project has been built under Win32, Linux, and OSX. The following -packages and tools have been used: - -* All Systems: - -- Sun J2SDK 1.4.2 (available at java.sun.com) - -- ANT 1.5.3 (available at apache.org) - -- JUnit 3.8.1 (available at junit.org) copy junit.jar to the apache-ant lib directory - -* Windows: - -- Win32 (Win XP in the case of our machine) - -- OpenAL1.0 SDK from Creative Labs (available at http://developer.creative.com - under "Gaming -> Development Kits -> Open AL") - -- MinGW 2.0.0 plus the following updates: (all available at www.mingw.org) - -- binutils 2.13.90 - -- w32api-2.2 - -- mingw-runtime-2.4 - -* Linux: - -- Linux i386 (Redhat 9.0) - -- gcc 3.2.2, binutils 2.13.90 - -- OpenAL CVS version from opensource.creative.com (see CVS instructions at - www.openal.org) - -* OSX - -- OSX 10.2 or later - -- OSX Developer Tools - -- OpenAL1.0 SDK from Creative Labs (avaulable at http://developer.creative.com under "Gaming->Development Kits->Open AL") - - -Directory Organization: -======================= - -The root contains a master ANT build.xml and the following sub directories: - - -- apidocs Where the javadocs get built to - -- lib Where the Jar and DLL files get built to - -- src The actual source for the JGI APIs. - -- www JGI project webpage files - - -Preparations: -============= - -* Windows: - Grab the OpenAL SDK from the openal.org downloads and install it. - -* Linux: - OpenAL comes with various Linux distributions. You might have it already. - If not, try rpmfind, apt-get or emerge. - - For the newest version you need to compile OpenAL yourself from CVS: - - -- follow the instruction at www.openal.org to check out a fresh copy - -- in the linux subdir type './autogen.sh - -- look at the build options with ./configure --help - -- configure it with./configure --enable-sdl --enable-vorbis [-enable-more] - (see openal.spec for a full set) - -- build it with make && make test and run the tests - -- as root type make install - -- add /usr/local/lib to you /etc/ld.so.conf and run ldconfig - -* OSX: - Grab the OpenAL SDK from Creative Labs and install it. - -JOAL Build Instructions: -=================== - -Edit the value of the jdk.home property in the root build.xml file to point -to your Java 2 SDK installation (ex: c:/j2sdk1.4.2 ,/opt/j2sdk1.4.2, or /Library/Java/Home) - -Edit the value of the openal.home property in the root build.xml file to point -to your OpenAL SDK installation. For Windows this might be -"c:/program files/creative labs/openal 1.0 sdk". -Under Linux set the property to the toplevel directory of your OpenAL CVS version. -If OpenAl came with your distribution and the header files are in /usr/include/AL, -set the property to '/usr'. Under OSX the default distribution will install to "/Library/Frameworks/OpenAL.framework ". - -To clean: ant clean -To build: ant all (or just ant) -To build docs: ant javadoc -To test: ant runtests - - -Release Info: - Initial Release: This release contains an implementation of the Java - bindings for OpenAL, as well as the Sound3D Object-Oriented toolkit for games. - -Additional Information - This release includes source code adapted from the Lightweight Java Games Library - subject to the following terms and conditions: - - * Copyright (c) 2002 Light Weight Java Game Library Project - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions are - * met: - * - * * Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * * Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * * Neither the name of 'Light Weight Java Game Library' nor the names of - * its contributors may be used to endorse or promote products derived - * from this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED - * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR - * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR - * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, - * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, - * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR - * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF - * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING - * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS - * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - - |