From 8c722cac797fc6ca88741d41a1cf8009a29400eb Mon Sep 17 00:00:00 2001
From: Niclas Zeising <zeising@FreeBSD.org>
Date: Fri, 14 Sep 2018 19:04:25 +0000
Subject: [PATCH] Document USES=gl properly.

Reviewed by:	mat, bcr
Differential Revision:	https://reviews.freebsd.org/D17114
---
 .../books/porters-handbook/uses/chapter.xml   | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
index b9ffba1e05..6d41bbd79b 100644
--- a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -689,6 +689,91 @@
       build- and run-time dependencies.</para>
   </sect1>
 
+  <sect1 xml:id="uses-gl">
+    <title><literal>gl</literal></title>
+
+    <para>Possible arguments: (none)</para>
+
+    <para>Provides an easy way to depend on
+      <application>GL</application> components.  The components
+      should be listed in <varname>USE_GL</varname>.  The available
+      components are:</para>
+
+    <variablelist>
+      <varlistentry>
+	<term><literal>egl</literal></term>
+
+	<listitem>
+	  <para>add a library dependency on <filename>libEGL.so</filename>
+	    from <package role="port">graphics/mesai-libs</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><literal>gbm</literal></term>
+
+	<listitem>
+	  <para>Add a library dependency on <filename>libgbm.so</filename>
+	    from <package role="port">graphics/mesa-libs</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><literal>gl</literal></term>
+
+	<listitem>
+	  <para>Add a library dependency on <filename>libGL.so</filename>
+	    from <package role="port">graphics/mesa-libs</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><literal>glesv2</literal></term>
+
+	<listitem>
+	  <para>Add a library dependency on <filename>libGLESv2.so</filename>
+	    from <package role="port">graphics/mesa-libs</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><literal>glew</literal></term>
+
+	<listitem>
+	  <para>Add a library dependency on <filename>libGLEW.so</filename>
+	    from <package role="port">graphics/glew</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><literal>glu</literal></term>
+
+	<listitem>
+	  <para>Add a library dependency on <filename>libGLU.so</filename>
+	    from <package role="port">graphics/libGLU</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><literal>glut</literal></term>
+
+	<listitem>
+	  <para>Add a library dependency on <filename>libglut.so</filename>
+	    from <package role="port">graphics/freeglut</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term><literal>glw</literal></term>
+
+	<listitem>
+	  <para>Add a library dependency on <filename>libGLw.so</filename>
+	    from <package role="port">graphics/libGLw</package></para>
+	</listitem>
+      </varlistentry>
+    </variablelist>
+  </sect1>
+
   <sect1 xml:id="uses-gmake">
     <title><literal>gmake</literal></title>