diff --git a/CHANGES b/CHANGES
index c9c245c59..43b49cde3 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,6 @@
 CHANGES IN FLTK 1.1.8
 
-	- Documentation fix (STR #1336)
+	- Documentation fixes (STR #1336, STR #1329)
 	- Added support for floating point Fl_Spinner in the
 	  API, documentation, and Fluid (STR #1331)
 	- Repeat button now cancels timeout if it should get 
diff --git a/documentation/Fl_Gl_Window.html b/documentation/Fl_Gl_Window.html
index 84bddd7e0..e011f660a 100644
--- a/documentation/Fl_Gl_Window.html
+++ b/documentation/Fl_Gl_Window.html
@@ -38,6 +38,13 @@ are very useful for drawing UI controls atop your 3D graphics.  If the
 overlay hardware is not provided, FLTK tries to simulate the overlay,
 This works pretty well if your graphics are double buffered, but not
 very well for single-buffered. </P>
+<P>Please note that the FLTK drawing and clipping functions
+will not work inside an <tt>Fl_Gl_Window</tt>. All drawing
+should be done using OpenGL calls exclusively.
+Even though <tt>Fl_Gl_Widget</tt> is derived from <tt>Fl_Group</tt>, 
+it is not useful to add other FLTK Widgets as children,
+unless those Widgets are modified to draw using OpenGL calls.</P>
+
 <H3>Methods</H3>
 <CENTER>
 <TABLE width=90% summary="Fl_Gl_Window methods.">