svn commit: r52658 - head/en_US.ISO8859-1/htdocs/releases/12.0R/relnotes

[Glen Barber]

Author: gjb
Date: Mon Dec 10 21:04:21 2018
New Revision: 52658
URL: https://svnweb.freebsd.org/changeset/doc/52658

Log:
  Add a section specific to graphics support, content provided by
  the graphics team.
  Add a link to the Graphics Wiki page.
  
  Sponsored by:	The FreeBSD Foundation

Modified:
  head/en_US.ISO8859-1/htdocs/releases/12.0R/relnotes/relnotes.xml

Modified: head/en_US.ISO8859-1/htdocs/releases/12.0R/relnotes/relnotes.xml
==============================================================================
--- head/en_US.ISO8859-1/htdocs/releases/12.0R/relnotes/relnotes.xml	Mon Dec 10 20:34:18 2018	(r52657)
+++ head/en_US.ISO8859-1/htdocs/releases/12.0R/relnotes/relnotes.xml	Mon Dec 10 21:04:21 2018	(r52658)
@@ -712,6 +712,68 @@
 	<acronym>MMU</acronym> initialization has been added.</para>
     </sect2>
 
+    <sect2 xml:id="hardware-graphics">
+      <title>Graphics Support</title>
+
+      <para>&os; has changed the way graphics drivers are handled on
+	&arch.amd64; and &arch.i386;.  Graphics drivers for modern
+	ATI/&amd; and &intel; graphics cards are now available in the
+	Ports Collection.  The base drivers are still available and
+	will be installed by default, but they lack support for
+	current generation laptop and desktop systems.</para>
+
+      <para>In most cases it is enough to install <filename
+	  role="package">graphics/drm-kmod</filename>
+	from ports or packages to install a driver appropriate for the
+	system, then adding the appropriate driver to
+	<varname>kld_list</varname> in &man.rc.conf.5;.</para>
+
+      <para>For &intel; (i915) systems after Broadwell™, the
+	&man.rc.conf.5; entry is:</para>
+
+      <programlisting>kld_list=/boot/modules/i915kms.ko.</programlisting>
+
+      <para>Systems with ATI/&amd; graphics cards have two options.
+	Modern systems starting with the HD7000 series GPU should
+	use:</para>
+
+      <programlisting>kld_list=/boot/modules/amdgpu.ko</programlisting>
+
+      <para>Systems with cards released before the HD7000 GPU
+	use:</para>
+
+      <programlisting>kld_list=/boot/modules/radeonkms.ko.</programlisting>
+
+      <note>
+	<para>Users must be added to the <literal>video</literal>
+	  <acronym>GID</acronym> after installing <filename
+	    role="package">graphics/drm-kmod</filename> in order for
+	  <application>X</application> to start properly.</para>
+      </note>
+
+      <note>
+	<para>There are known issues with the
+	  <literal>xserver</literal> driver provided by <filename
+	    role="package">x11-drivers/xf86-video-ati</filename>
+	  when using graphics drivers from the base system;
+	  <filename
+	    role="package">x11-drivers/xf86-video-ati-legacy</filename>
+	  should be used instead.</para>
+      </note>
+
+      <note>
+	<para>There is a known issue where booting with
+	  <acronym>UEFI</acronym> and using the ATI/&amd; graphics
+	  driver may cause the screen to be garbled before the
+	  appropriate driver is loaded.</para>
+      </note>
+
+      <para>For additional information regarding graphics support on
+	&os;, please see the <link
+	  xlink:href="https://wiki.freebsd.org/Graphics">Graphics Wiki
+	  Page</link>.</para>
+    </sect2>
+
     <sect2 xml:id="hardware-virtualization">
       <title>Virtualization Support</title>