        Switching to a new GLEW version
        ===============================

Step 1: Edit the new GLEW files:
--------------------------------

Copy file glew.h.orig into directory GL, rename to glew.h and edit according
to the notes below.

Note 1: File glew.c
Set the global variable glewExperimental to GL_TRUE.

Note 2: File glew.h
Replace all occurences of "[]" with a pointer.
Example: "const double v[]" should be replaced with "const double *v".

In GLEW 1.5.4 and 1.5.7 there have been 3 occurences of that kind.

Note 3: File glew.h 
Replace

#if defined(__sgi) && !defined(__GNUC__)
#include <inttypes.h>
#else
#include <stdint.h>
#endif

with:

#if (defined(__sgi) && !defined(__GNUC__)) || defined(IRIX)
#include <inttypes.h>
#else
#include <stdint.h>
#endif

Note 4: File glew.h
Add the following lines after:
#  if defined(__MINGW32__) 
#include <inttypes.h>
#  endif

#  if defined(IRIX) 
#include <inttypes.h>
#  endif

This step is not necessary anymore with GLEW 1.5.4.

Note 5: File glew.h
Add "const" before "*params" parameter:
PFNGLPOINTPARAMETERFVPROC
PFNGLPOINTPARAMETERIVPROC
PFNGLPOINTPARAMETERFVARBPROC
PFNGLPOINTPARAMETERFVEXTPROC

This step is not necessary anymore with GLEW 1.5.7.

Note 6: File glew.h
Replace: 
#define GL_TIMEOUT_IGNORED 0xFFFFFFFFFFFFFFFF
with:
#define GL_TIMEOUT_IGNORED 0xFFFFFFFF

Step 2: Check for new OpenGL extensions:
----------------------------------------
Goto the list of extensions by number:
http://www.opengl.org/registry/#arbextspecs

HTML file "glExtUrlList.html" is taken from that webpage and manually reduced (TODO: How). 
It must be transformed with script "createExtUrlList.tcl" into a line-oriented
text version: "glExtUrlList.txt".

> tclsh createExtUrlList.tcl

This is done automatically in the Makefile.

This file is used as list of existing extensions to script
"createSwigAndHelpFile.tcl".

Step 3: Build and install:
--------------------------
> make install

This generates a first version of Tcl3D, which is needed for the bootstrap
process to generate the OpenGL documentation list.

Step 4: Update the OpenGL documentation list:
---------------------------------------------
Step 2 has created a new version of tcl3dOglHelp.tcl, which holds 
the names of all wrapped OpenGL functions.
Now create the list of corresponding OpenGL reference pages on www.opengl.org.

> tclsh createFuncUrlList.tcl

This creates the file "GLSpec/glFuncUrlList.txt", which is needed for the build
process.
Also this script loads all referenced HTML files from www.opengl.org and
stores them in folder "../applications/RefPages".

This step needs an Internet connection and takes quite some time.

Step 5: Build and install:
--------------------------
Incorporate the changed documentation reference list into the distribution.

> make install

