From c7016dc6489f6a61d7845179f550628c50fe2b34 Mon Sep 17 00:00:00 2001
From: dcnieho <dcnieho@7f0cb862-5218-0410-a997-914c9d46530a>
Date: Mon, 26 Mar 2012 13:51:15 +0000
Subject: [PATCH] added not about wrong winding of teapot vertices, as is in
 the original glut manpages

git-svn-id: https://svn.code.sf.net/p/freeglut/code/trunk@1215 7f0cb862-5218-0410-a997-914c9d46530a
---
 freeglut/web-src/docs/api.php | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/freeglut/web-src/docs/api.php b/freeglut/web-src/docs/api.php
index 1466dbf..d279546 100644
--- a/freeglut/web-src/docs/api.php
+++ b/freeglut/web-src/docs/api.php
@@ -2036,8 +2036,23 @@ draw a wireframe and solid teapot respectively.
 <p><b>Description</b></p>
 
 <p>The <tt>glutWireTeapot</tt> and <tt>
-  glutSolidTeapot</tt> functions render a teapot of the desired size, centered
-at the origin.  This is the famous OpenGL teapot [add reference]. </p>
+  glutSolidTeapot</tt> functions render a teapot of the desired size,
+  centered at the origin.  This is the famous OpenGL teapot [add
+  reference]. </p>
+
+<p><b>Bugs</b></p>
+<p>OpenGL's default <tt>glFrontFace</tt> state assumes that front facing
+polygons (for the purpose of face culling) have vertices that wind
+counter clockwise when projected into window space. This teapot is
+rendered with its front facing polygon vertices winding clockwise. For
+OpenGL's default back face culling to work, you should use:</p>
+
+<p><tt>&nbsp;&nbsp;glFrontFace(GL_CW);<br>
+&nbsp;&nbsp;glutSolidTeapot(size);<br>
+&nbsp;&nbsp;glFrontFace(GL_CCW);</tt></p>
+
+<p>Both these bugs reflect issues in the original aux toolkit's teapot
+rendering routines (GLUT used the same teapot rendering routine).</p>
 
 <p><b>Changes From GLUT</b></p>