KNOWN_PROBLEMS

* Does not support dynamic detection of OpenGL API support
  and does not have bindings for modern OpenGL API since
  approximately version 2.0

* No way to specify/override the compile and link
  options which causes problems on systems with multiple
  OpenGL libraries installed (e.g., 32-bit and 64-bit).

* Build may not complete if you do not have the
  required FreeGLUT or Apple GLUT (on Mac OS X systems).

* The build may fail if your FreeGLUT installation uses
  freeglut.h as the name of its include file.  This may
  happen if you have both original GLUT and FreeGLUT on
  the same system.  Edit the Makefile produced and add
  -DHAVE_FREEGLUT_H to the DEFINE = line and things may
  compile then.

* Configuration and compiling requires an active OpenGL
  context on non-win32 systems (e.g. a display)

* Too many "extra" variants of standard OpenGL functions.
  Implementation progress with PDL has suggested a way
  to simplify the bindings a la OpenGL::Simple.  TBD.

* examples/planets:  works but has visual artifacts
  examples/tk_steal: runs but maybe not correctly 

*  Examples using GLX calls need to be ported to GLUT

* Some of the functions taking pointer type arguments
  have inconsistent usage for the gl*_p() variants:

    glBufferDataARB_p(target,oga,usage)
    glBufferSubDataARB_p(target,offset,oga)
    glColorPointer_p(size, oga)
    glEdgeFlagPointer_p(oga)
    glIndexPointerEXT_p(oga)
    glIndexPointer_p(oga)
    glNormalPointerEXT_p(oga)
    glNormalPointer_p(oga)
    glTexCoordPointerEXT_p(size, oga)
    glTexCoordPointer_p(size, oga)
    glVertexPointerEXT_p(size, oga)
    glVertexPointer_p(size, oga)

* OpenGL::RPN operations can segfault.  Work is underway
  to debug the stack issues which appear to be the root
  cause.