Better doc for using OpenGL version 3.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@13023 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

2 files changed, 10 insertions, 15 deletions

diff --git a/FL/Fl_Gl_Window.H b/FL/Fl_Gl_Window.H
index b4b0409a0..48b7d39b0 100644
--- a/FL/Fl_Gl_Window.H
+++ b/FL/Fl_Gl_Window.H
@@ -173,16 +173,7 @@ public:
    
    The FL_OPENGL3 flag is required to access OpenGL version 3 or more
    under the X11 and MacOS platforms; it's optional under Windows.
-   
-   \note On the <b>Windows and Unix/Linux platforms</b>, FLTK produces
-   contexts for the highest OpenGL version supported by the hardware. Such contexts
-   are also compatible with lower OpenGL versions. On the <b>Apple OS X
-   platform</b>, it is necessary to decide whether the source code targets
-   OpenGL versions higher or lower than 3.0. By default, FLTK
-   creates contexts adequate for OpenGL versions 1 and 2. To get contexts
-   for OpenGL 3.0 or higher, the <tt>FL_OPENGL3</tt> flag and Mac OS
-   version 10.7 or higher are required (in that case the context is NOT 
-   compatible with OpenGL versions 1 or 2).
+   See more details in \ref opengl3.
    
    \version the <tt>FL_OPENGL3</tt> flag appeared in version 1.3.4
    */
diff --git a/documentation/src/opengl.dox b/documentation/src/opengl.dox
index 7e75e82b7..91983f0c9 100644
--- a/documentation/src/opengl.dox
+++ b/documentation/src/opengl.dox
@@ -460,13 +460,17 @@ To access OpenGL 3.0 (or higher versions), use the <tt>FL_OPENGL3</tt> flag
 when calling Fl_Gl_Window::mode(int a) or glutInitDisplayMode().
 
 <b>On the Windows and Unix/Linux platforms</b>, FLTK creates contexts
-implementing the highest OpenGL version supported by the hardware,
-which are also compatible with lower OpenGL versions. Thus, FLTK allows
-source code targeting any version of OpenGL. Access to functions from OpenGL
+implementing the highest OpenGL version supported by the hardware.
+Such contexts may also be compatible with lower OpenGL versions.
+Access to functions from OpenGL
 versions above 1.1 requires to load function pointers at runtime on these platforms.
 FLTK recommends to use the GLEW library to perform this. It is therefore
-necessary to install the GLEW library (see below).  <b>On the macOS platform</b>,
-MacOS 10.7 or above is required; GLEW is possible but not necessary.
+necessary to install the GLEW library (see below).
+
+<b>On the macOS platform</b>, MacOS 10.7 or above is required;
+GLEW is possible but not necessary. FLTK creates contexts for OpenGL
+versions 1 and 2 without the FL_OPENGL3
+flag and for OpenGL versions 3.2 and above with it.
 
 \par GLEW installation (Unix/Linux and Windows platforms)
 GLEW is available as a package for most Linux distributions and in source