This directory and its subdirectories contains the OpenGL Utility
Toolkit (GLUT) distribution.  See the NOTICE for legal terms.

VERSION:

Release 2.3, Aug 2, 1995.

SUPPORTED MACHINES:

This distribution should compile for:

  o  DEC Alpha workstation running OSF/1 with Open3D layered product

  o  IBM RS/6000 workstations running AIX with OpenGL support

  o  SGI workstation running IRIX 5.2 or higher supporting OpenGL

  o  Template Graphics Software's OpenGL for Sun workstations

  o  Mesa 1.2 (and 1.1) for Unix workstations, including Linux PCs
     and SunOS 4.1.x.

MAKEFILE GENERATION:

Use mkmkfiles.sgi to put Makefiles using the SGI Makefile conventions
in place.  Use mkmkfiles.imake to put Makefiles generated from
Imakefiles in place.  Run one of these two commands in this directory,
then do a "make".

CONTENTS OVERVIEW BY DIRECTORY:

  GL - GLUT interface header files

  lib - source code for GLUT libraries

     glut - GLUT library implementation

     fglut - GLUT FORTRAN bindings.

  test - test programs for GLUT library

  progs - programs using GLUT

     examples - misc. GLUT examples

     redbook - examples from the OpenGL Programming Guide ported to GLUT

     contrib - contributed GLUT examples

     demos - more involved OpenGL demos using GLUT

     fortran - GLUT FORTRAN examples

DOCUMENTATION:

See the other README files in this directory.  There is a complete
specification for GLUT API version 2 in PostScript available by
anonymous ftp accompanying this distribution.

SHAMELESS BUT HOPEFULLY HELPFUL PLUG:

Since November 1994, The X Journal carries a column on OpenGL that I
write.  Each column uses GLUT for the examples.  If you are looking to
learn about OpenGL, this may be a good place.  The X Journal (ISSN
1056-7003) is published six times per year, bimonthly by SIGS
Publications, 71 West 23rd St, 3rd floor, NY, NY 10010, 212-242-7447.
Subscription rates - one year (six issues) individual:  $39 domestic;
$64 Canada and Mexico; $79 foreign; institutional: $99 domestic; $124
Canada and Mexico; $139 foreign.  Send address changes and subscription
orders to:  The X Journal, PO Box 5050, Brentwood, TN 37024-5050.  For
service on current subscriptions, call 800-361-1279(v); or
215-785-6073(f); or subscriptions@sigs.com (email).

BUG REPORTING:

Send bug reports by electronic mail to mjk@sgi.com

Questions of a general interest about GLUT will be answered on the
comp.graphics.opengl newsgroup.

ACKNOWLEDGEMENTS:

Much thanks to OpenGL engineers at DEC, IBM, Microsoft, SGI, and TGS as
well as Brian Paul from the University of Wisconsin for helping me
ensure the portability of this code to non-SGI graphics platforms.
Also thank you to GLUT users for your feedback and bug fixes.

- Mark Kilgard
  mjk@sgi.com