Add examples of setting specific video cards.

Reviewed by:	kwm, ak, Avengence on IRC freebsd-xorg

1 files changed, 80 insertions, 4 deletions

diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.xml b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
index f51ed29471..686d5ba368 100644
--- a/en_US.ISO8859-1/books/handbook/x11/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
@@ -409,8 +409,14 @@
 
 	  <listitem>
 	    <para>3D acceleration is supported on most &intel;
-	      graphics, including IronLake, SandyBridge, and
-	      IvyBridge.</para>
+	      graphics up to Ivy Bridge (HD Graphics 2500, 4000, and
+	      P4000), including Iron Lake (HD Graphics) and
+	      Sandy Bridge (HD Graphics 2000).</para>
+
+	    <para>Driver name: <literal>intel</literal></para>
+
+	    <para>For reference, see <link
+	        xlink:href="https://en.wikipedia.org/wiki/List_of_Intel_graphics_processing_units"/>.</para>
 	  </listitem>
 	</varlistentry>
 
@@ -420,6 +426,11 @@
 	  <listitem>
 	    <para>2D and 3D acceleration is supported on Radeon
 	      cards up to and including the HD6000 series.</para>
+
+	    <para>Driver name: <literal>radeon</literal></para>
+
+	    <para>For reference, see <link
+	        xlink:href="https://en.wikipedia.org/wiki/List_of_AMD_graphics_processing_units"/>.</para>
 	  </listitem>
 	</varlistentry>
 
@@ -431,6 +442,9 @@
 	      <filename>x11</filename> category of the Ports
 	      Collection.  Install the driver that matches the video
 	      card.</para>
+
+	    <para>For reference, see <link
+	      xlink:href="https://en.wikipedia.org/wiki/List_of_Nvidia_graphics_processing_units"/>.</para>
 	  </listitem>
 	</varlistentry>
 
@@ -444,7 +458,7 @@
 	      &intel; and NVIDIA hardware.
 	      <emphasis>Switchable Graphics</emphasis> or
 	      <emphasis>Hybrid Graphics</emphasis> are a combination
-	      of &intel; and an &amd; Radeon
+	      of an &intel; or &amd; processor and an &amd; Radeon
 	      <acronym>GPU</acronym>.</para>
 
 	    <para>Implementations of these hybrid graphics systems
@@ -461,7 +475,12 @@
 	      driver.</para>
 
 	    <para><acronym>BIOS</acronym> settings depend on the model
-	      of computer.</para>
+	      of computer.  In some situations, both
+	      <acronym>GPU</acronym>s can be left enabled, but
+	      creating a configuration file that only uses the main
+	      <acronym>GPU</acronym> in the <literal>Device</literal>
+	      section is enough to make such a system
+	      functional.</para>
 	  </listitem>
 	</varlistentry>
 
@@ -488,6 +507,63 @@
 	      <acronym>UEFI</acronym> and &arm; computers.</para>
 	  </listitem>
 	</varlistentry>
+
+	<varlistentry xml:id="x-config-video-cards-file">
+	  <term>Setting the Video Driver in a File</term>
+
+	  <listitem>
+	    <para>To set the &intel; driver in a configuration
+	      file:</para>
+
+	    <example>
+	      <title>Select &intel; Video Driver in a File</title>
+
+	      <para><filename>/usr/local/etc/X11/xorg.conf.d/driver-intel.conf</filename></para>
+
+	      <programlisting>Section "Device"
+	Identifier "Card0"
+	Driver     "intel"
+	# BusID    "PCI:1:0:0"
+EndSection</programlisting>
+
+	      <para>If more than one video card is present, the
+		<literal>BusID</literal> identifier can be uncommented
+		and set to select the desired card.  A list of video
+		card bus <acronym>ID</acronym>s can be displayed with
+		<command>pciconf -lv | grep -B3
+		  display</command>.</para>
+	    </example>
+
+	    <para>To set the Radeon driver in a configuration
+	      file:</para>
+
+	    <example>
+	      <title>Select Radeon Video Driver in a File</title>
+
+	      <para><filename>/usr/local/etc/X11/xorg.conf.d/driver-radeon.conf</filename></para>
+
+	      <programlisting>Section "Device"
+	Identifier "Card0"
+	Driver     "radeon"
+EndSection</programlisting>
+	    </example>
+
+	    <para>To set the <acronym>VESA</acronym> driver in a
+	      configuration file:</para>
+
+	    <example>
+	      <title>Select <acronym>VESA</acronym> Video Driver in a
+		File</title>
+
+	      <para><filename>/usr/local/etc/X11/xorg.conf.d/driver-vesa.conf</filename></para>
+
+	      <programlisting>Section "Device"
+	Identifier "Card0"
+	Driver     "vesa"
+EndSection</programlisting>
+	    </example>
+	  </listitem>
+	</varlistentry>
       </variablelist>
     </sect2>