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

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

Copy the following files (glew.h, glxew.h and wglew.h) from the new GLEW version into directory tcl3dOgl/GL.
Copy file glew.c from the new GLEW version into directory tcl3dOgl.

Then 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".

Note 3: File glew.h
Replace: 
#define GL_TIMEOUT_IGNORED 0xFFFFFFFFFFFFFFFFull
with:
#define GL_TIMEOUT_IGNORED 0xFFFFFFFF

Replace: 
#define GL_TIMEOUT_IGNORED_APPLE 0xFFFFFFFFFFFFFFFFull
with:
#define GL_TIMEOUT_IGNORED_APPLE 0xFFFFFFFF

Replace: 
#define GL_INVALID_INDEX 0xFFFFFFFFu
with:
#define GL_INVALID_INDEX 0xFFFFFFFF

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

HTML file "glExtUrlList.html" is taken from that webpage and manually reduced:
Remove all HTML code from beginning till first occurence of the list of
extensions. Remove HTML code from the end of the file after last extension
definition.

It must be transformed with script "createExtUrlList.tcl" into a line-oriented
text version: "glExtUrlList.txt".
This file is used as list of existing extensions to script "createSwigAndHelpFile.tcl".

> tclsh createExtUrlList.tcl

Create first versions of wrapper and OpenGL help files:
> tclsh createSwigAndHelpFile.tcl -swig
> tclsh createSwigAndHelpFile.tcl -help


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 3 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 or www.khronos.org
and stores them in folder "../applications/RefPages".

Note: 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.

> tclsh createExtUrlList.tcl
> tclsh createSwigAndHelpFile.tcl -swig
> tclsh createSwigAndHelpFile.tcl -help

> make install

