Porter's Handbook: Update USE_XORG component list

It has been outdated since August 2018 when all *proto ports have
been folded into xorgproto.  Component descriptions are auto-generated
from the underlying COMMENTs.

Approved by:	mat
Differential Revision:	https://reviews.freebsd.org/D19642

1 files changed, 303 insertions, 19 deletions

diff --git a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
index 0865c02804..ff73024e76 100644
--- a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -1539,27 +1539,311 @@ USE_PERL5=	modbuildtiny</programlisting>
       <para>The X11 implementation available in The Ports Collection
 	is X.Org.  If the application depends on X components, set
 	<varname>USE_XORG</varname> to the list of required
-	components.  Available components, at the time of writing,
-	are:</para>
-
-      <para><literal>bigreqsproto compositeproto damageproto dmx
-	  dmxproto dri2proto dri3proto evieproto fixesproto
-	  fontcacheproto fontenc fontsproto fontutil glproto ice
-	  inputproto kbproto libfs oldx pciaccess pixman presentproto
-	  printproto randrproto recordproto renderproto resourceproto
-	  scrnsaverproto sm trapproto videoproto x11 xau xaw xaw6 xaw7
-	  xbitmaps xcb xcmiscproto xcomposite xcursor xdamage xdmcp
-	  xevie xext xextproto xf86bigfontproto xf86dgaproto
-	  xf86driproto xf86miscproto xf86rushproto xf86vidmodeproto
-	  xfixes xfont xfontcache xft xi xinerama xineramaproto
-	  xkbfile xkbui xmu xmuu xorg-macros xorg-server xp xpm
-	  xprintapputil xprintutil xproto xproxymngproto xrandr
-	  xrender xres xscrnsaver xshmfence xt xtrans xtrap xtst xv
-	  xvmc xxf86dga xxf86misc xxf86vm</literal>.</para>
-
-      <para>Always up-to-date list can be found in
+	components.  A full list can be found in <xref
+	linkend="using-x11-components" />.  An always up-to-date
+	list can be found in
 	<filename>/usr/ports/Mk/bsd.xorg.mk</filename>.</para>
 
+      <table frame="none" xml:id="using-x11-components">
+	<title>Available X.Org Components</title>
+
+	<tgroup cols="2">
+	  <thead>
+	    <row>
+	      <entry>Name</entry>
+	      <entry>Description</entry>
+	    </row>
+	  </thead>
+
+	  <!-- From any ports checkout, run
+	    for m in $(make -C x11/libX11 -V XORG_MODULES:O); do
+	        port=$(make -C x11/libX11 -V "${m}_LIB_PC_DEPENDS:C/^.*://")
+	        if [ -z "$port" ]; then
+	            port=$(make -C x11/libX11 -V "${m}_BUILD_DEPENDS:C/^.*://")
+	        fi
+	        description=$(make -C "$port" -V COMMENT)
+	        printf "<row>\n<entry><literal>$m</literal></entry>\n<entry>$description</entry>\n</row>\n\n"
+	    done
+	    -->
+	  <tbody>
+	    <row>
+	      <entry><literal>dmx</literal></entry>
+	      <entry>DMX extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>fontenc</literal></entry>
+	      <entry>The fontenc Library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>fontutil</literal></entry>
+	      <entry>Create an index of X font files in a
+		directory</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>ice</literal></entry>
+	      <entry>Inter Client Exchange library for X11</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>libfs</literal></entry>
+	      <entry>The FS library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>oldx</literal></entry>
+	      <entry>Old X library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>pciaccess</literal></entry>
+	      <entry>Generic PCI access library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>pixman</literal></entry>
+	      <entry>Low-level pixel manipulation library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>sm</literal></entry>
+	      <entry>Session Management library for X11</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>x11</literal></entry>
+	      <entry>X11 library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xau</literal></entry>
+	      <entry>Authentication Protocol library for X11</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xaw</literal></entry>
+	      <entry>X Athena Widgets library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xaw6</literal></entry>
+	      <entry>X Athena Widgets library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xaw7</literal></entry>
+	      <entry>X Athena Widgets library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xbitmaps</literal></entry>
+	      <entry>X.Org bitmaps data</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xcb</literal></entry>
+	      <entry>The X protocol C-language Binding (XCB)
+		library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xcomposite</literal></entry>
+	      <entry>X Composite extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xcursor</literal></entry>
+	      <entry>X client-side cursor loading library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xdamage</literal></entry>
+	      <entry>X Damage extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xdmcp</literal></entry>
+	      <entry>X Display Manager Control Protocol
+		library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xevie</literal></entry>
+	      <entry>The Xevie library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xext</literal></entry>
+	      <entry>X11 Extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xfixes</literal></entry>
+	      <entry>X Fixes extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xfont</literal></entry>
+	      <entry>X font library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xfont2</literal></entry>
+	      <entry>X font library version 2.x</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xfontcache</literal></entry>
+	      <entry>The Xfontcache library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xft</literal></entry>
+	      <entry>Client-sided font API for X applications</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xi</literal></entry>
+	      <entry>X Input extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xinerama</literal></entry>
+	      <entry>X11 Xinerama library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xkbfile</literal></entry>
+	      <entry>XKB file library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xkbui</literal></entry>
+	      <entry>The xkbui library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xmu</literal></entry>
+	      <entry>X Miscellaneous Utilities libraries</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xmuu</literal></entry>
+	      <entry>X Miscellaneous Utilities libraries</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xorg-macros</literal></entry>
+	      <entry>X.Org development aclocal macros</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xorg-server</literal></entry>
+	      <entry>X.Org X server and related programs</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xorgproto</literal></entry>
+	      <entry>X.Org protocol headers</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xp</literal></entry>
+	      <entry>X print library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xpm</literal></entry>
+	      <entry>X Pixmap library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xprintapputil</literal></entry>
+	      <entry>The XprintAppUtil library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xprintutil</literal></entry>
+	      <entry>The XprintUtil library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xrandr</literal></entry>
+	      <entry>X Resize and Rotate extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xrender</literal></entry>
+	      <entry>X Render extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xres</literal></entry>
+	      <entry>X Resource usage library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xscrnsaver</literal></entry>
+	      <entry>The XScrnSaver library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xshmfence</literal></entry>
+	      <entry>Shared memory 'SyncFence' synchronization
+		primitive</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xt</literal></entry>
+	      <entry>X Toolkit library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xtrans</literal></entry>
+	      <entry>Abstract network code for X</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xtrap</literal></entry>
+	      <entry>The XTrap library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xtst</literal></entry>
+	      <entry>X Test extension</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xv</literal></entry>
+	      <entry>X Video Extension library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xvmc</literal></entry>
+	      <entry>X Video Extension Motion Compensation
+		library</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xxf86dga</literal></entry>
+	      <entry>X DGA Extension</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xxf86misc</literal></entry>
+	      <entry>X XF86-Misc Extension</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>xxf86vm</literal></entry>
+	      <entry>X Vidmode Extension</entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </table>
+
       <para>The Mesa Project is an effort to provide free OpenGL
 	implementation.  To specify a dependency on various
 	components of this project, use <literal>USES= gl</literal>