Todo list updated. Build instructions detailed.
authorPhilippe Houdoin <phoudoin@freedesktop.org>
Tue, 24 Aug 2004 08:31:57 +0000 (08:31 +0000)
committerPhilippe Houdoin <phoudoin@freedesktop.org>
Tue, 24 Aug 2004 08:31:57 +0000 (08:31 +0000)
docs/README.BEOS

index 8c9434db49dff7b1936d735b2cb6d74f677845df..0a10b005f24d7df22c3bd955605026a4d15097a1 100644 (file)
@@ -32,12 +32,22 @@ Requirements:
   - gcc version 2.95.3 for BeOS 
   You can find it here: http://www.bebits.com/app/2157
 
-To build Mesa-powered BeOS libGL.so version, type this at root folder:
+To build Mesa-powered BeOS libGL.so version, open an Terminal window,
+move to Mesa root folder and type this command:
 
 $ make beos
 
+Note that the "beos" argument is only needed the first time to setup build config.
+Next times, typing "make" will be enough.
+
 When it finishes the Mesa based libGL.so library for
-BeOS will be in the lib/ directory.
+BeOS will be in the lib/ directory, along libglut.so library.
+Several demo/test programs should have been build too under progs/* folders.
+If it stop when building one of the progs/* programs, you may want to ignore it
+and force make to move on next target by adding the -k make option:
+
+$ cd progs
+$ make -k
 
 To install it as Be's default libGL.so replacement, put it in your 
 /boot/home/config/lib/ directory. All your GL/GLUT apps will use 
@@ -50,26 +60,27 @@ yet.
 
 To build a DEBUG version, type instead this :
 
-$ DEBUG=1 make beos
+$ DEBUG=1 make
 
 
 * Example Programs
 
-Look in the progs/beos/ directory for one or two BGLView demo
-programs.  They should have been compiled along with the Mesa
-library.
+Look under progs/beos/ for some BGLView-based programs.
+You should find under progs/samples and progs/redbook directories GLUT-based programs too.
+They all should have been compiled along with the Mesa library.
 
 
 * GLUT
 
-A beta version of GLUT 3.7 port for BeOS can be found at 
+A beta version of GLUT 3.7 port for BeOS, made by Jake Hamby, can be found at 
 http://anobject.com/jehamby/Code/Glut-3.7-x86.zip.
+This is the version currently included in Mesa source code, and
+build in lib/libglut.so.
  
-There's is a 3.5 version in src/glut/beos/, too.
-The original distribution can be obtained from
-http://home.beoscentral.com/jehamby/Glut-3.5-x86.zip
+A previous 3.5 version of this GLUT BeOS port used to be available at
+http://home.beoscentral.com/jehamby/Glut-3.5-x86.zip.
 
-They are special version of GLUT adapted for the BeOS.  I don't
+They're special versions of GLUT for the BeOS platform.  I don't
 believe Mark Kilgard's normal GLUT distribution includes BeOS
 support.
 
@@ -87,8 +98,6 @@ cause a fatal error when running with Be's OpenGL.
 
 * Work Left To Do
 
-- Switch to SGI GLU implementation..
-- Add to build the BeOS GLUT port. Update it to latest known (3.7 ?)
 - BDirectWindow single buffering support is not implemented yet.
 - Color index mode is not implemented yet.
 - Reading pixels from the front buffer not implemented yet.
@@ -99,7 +108,8 @@ cause a fatal error when running with Be's OpenGL.
 
 * Other contributors to this BeOS port
 
-Marcin Konicki                   ahwayakchih <at> neoni <dot> net
+Jake Hamby                      jhamby <at> anobject <dot> com
+Marcin Konicki                  ahwayakchih <at> neoni <dot> net
 Francois Revol                  revol <at> free <dot> fr
 
 
@@ -121,4 +131,4 @@ as of February, 1999.
 
 
 ----------------------------------------------------------------------
-$Id: README.BEOS,v 1.10 2004/08/14 15:23:51 brianp Exp $
+$Id: README.BEOS,v 1.11 2004/08/24 08:31:57 phoudoin Exp $