update for begin-mode -> primitive-type
[clinton/guile-figl.git] / doc / gl.texi
index 0c77e8f..34ad9ff 100644 (file)
 @node About OpenGL
 @section About OpenGL
 
-OpenGL is a standard API for drawing three-dimensional graphics.  From
-its origin in Silicon Graphics's workstations the early 1990s, today
-it has become ubiquitous, with implementations on mobile phones,
-televisions, tablets, desktops, and even web browsers.
+The OpenGL API is a standard interface for drawing three-dimensional
+graphics.  From its origin in Silicon Graphics's workstations the
+early 1990s, today it has become ubiquitous, with implementations on
+mobile phones, televisions, tablets, desktops, and even web browsers.
 
 OpenGL has been able to achieve such widespread adoption not just
 because it co-evolved with powerful graphics hardware, but also
@@ -201,8 +201,8 @@ for more information.
 
 @subsubsection Begin/End Paradigm
 
-@defmac gl-begin begin-mode body ...
-Begin immediate-mode drawing with @var{begin-mode}, evaluate
+@defmac gl-begin primitive-type body ...
+Begin immediate-mode drawing with @var{primitive-type}, evaluate
 the sequence of @var{body} expressions, and then end drawing (as with
 @code{glBegin} and @code{glEnd}).
 
@@ -399,7 +399,7 @@ enumerator.
 @defun set-gl-depth-function func
 Specify the depth test function.  See the @code{depth-function}
 enumerator.
-p@end defun
+@end defun
 
 @defun set-gl-blend-color r g b a
 Specify the blend color.
@@ -518,10 +518,10 @@ The future is already here -- it's just not very evenly distributed.
 -- William Gibson
 @end quotation
 
-Before interfaces end up in core OpenGL, the are usually present as
-vendor-specific or candidate extensions.  Indeed, the making of an
-OpenGL standard these days seems to be a matter of simply collecting a
-set of mature extensions and making them coherent.
+Before interfaces end up in the core OpenGL API, the are usually
+present as vendor-specific or candidate extensions.  Indeed, the
+making of an OpenGL standard these days seems to be a matter of simply
+collecting a set of mature extensions and making them coherent.
 
 Figl doesn't currently provide specific interfaces for extensions.
 Perhaps it should, but that's a lot of work that we haven't had time