sync code with last improvements from OpenBSD

doc/gl-docs/GL/gl/cullface.3gl

@@ -0,0 +1,58 @@
+'\" te
+'\"! tbl|eqn | mmdoc
+'\"macro stdmacro
+.ds Vn Version 1.2
+.ds Dt 24 September 1999
+.ds Re Release 1.2.1
+.ds Dp Jan 14 18:30
+.ds Dm 01 cullface.
+.ds Xs 63441 4 cullface.gl
+.TH GLCULLFACE 3G
+.SH NAME
+.B "glCullFace
+\- specify whether front- or back-facing facets can be culled
+
+.SH C SPECIFICATION
+void \f3glCullFace\fP(
+GLenum \fImode\fP )
+.nf
+.fi
+
+.SH PARAMETERS
+.TP \w'\f2mode\fP\ \ 'u 
+\f2mode\fP
+Specifies whether front- or back-facing facets are candidates for culling.
+Symbolic constants
+\%\f3GL_FRONT\fP, \%\f3GL_BACK\fP, and \%\f3GL_FRONT_AND_BACK\fP are accepted.
+The initial value is \%\f3GL_BACK\fP.
+.SH DESCRIPTION
+\%\f3glCullFace\fP specifies whether front- or back-facing facets are culled
+(as specified by \f2mode\fP) when facet culling is enabled. Facet
+culling is initially disabled.
+To enable and disable facet culling, call the
+\%\f3glEnable\fP and \%\f3glDisable\fP commands
+with the argument \%\f3GL_CULL_FACE\fP.
+Facets include triangles,
+quadrilaterals,
+polygons,
+and rectangles.
+.P
+\%\f3glFrontFace\fP specifies which of the clockwise and counterclockwise facets
+are front-facing and back-facing.
+See \%\f3glFrontFace\fP.
+.SH NOTES
+If  \f2mode\fP is \%\f3GL_FRONT_AND_BACK\fP, no facets are drawn, but other
+primitives such as points and lines are drawn.
+.SH ERRORS
+\%\f3GL_INVALID_ENUM\fP is generated if \f2mode\fP is not an accepted value.
+.P
+\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glCullFace\fP
+is executed between the execution of \%\f3glBegin\fP
+and the corresponding execution of \%\f3glEnd\fP.
+.SH ASSOCIATED GETS
+\%\f3glIsEnabled\fP with argument \%\f3GL_CULL_FACE\fP
+.br
+\%\f3glGet\fP with argument \%\f3GL_CULL_FACE_MODE\fP
+.SH SEE ALSO
+\%\f3glEnable(3G)\fP,
+\%\f3glFrontFace(3G)\fP