svn commit: r49905 - head/en_US.ISO8859-1/books/handbook/x11

[Warren Block]

Author: wblock
Date: Sun Jan 29 16:14:25 2017
New Revision: 49905
URL: https://svnweb.freebsd.org/changeset/doc/49905

Log:
  Be more emphatic about not running -configure unless necessary.

Modified:
  head/en_US.ISO8859-1/books/handbook/x11/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Sun Jan 29 16:00:54 2017	(r49904)
+++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Sun Jan 29 16:14:25 2017	(r49905)
@@ -281,9 +281,15 @@
       <title>Quick Start</title>
 
       <para><application>&xorg;</application> supports most common
-	video cards, keyboards, and pointing devices.  These devices
-	are automatically detected and do not require any manual
-	configuration.</para>
+	video cards, keyboards, and pointing devices.</para>
+
+      <tip>
+	<para>Video cards, monitors, and input devices are
+	  automatically detected and do not require any manual
+	  configuration.  Do not create <filename>xorg.conf</filename>
+	  or run a <option>-configure</option> step unless automatic
+	  configuration fails.</para>
+      </tip>
 
       <procedure>
 	<step>
@@ -363,6 +369,10 @@
     <sect2 xml:id="x-config-files">
       <title>Configuration Files</title>
 
+      <para>Manual configuration is usually not necessary.  Please do
+	not manually create configuration files unless
+	autoconfiguration does not work.</para>
+
       <sect3 xml:id="x-config-files-directory">
 	<title>Directory</title>
 
@@ -870,6 +880,12 @@ EndSection</programlisting>
 	different configuration is desired.  For these cases, a custom
 	configuration file can be created.</para>
 
+      <warning>
+	<para>Do not create manual configuration files unless
+	  required.  Unnecessary manual configuration can prevent
+	  proper operation.</para>
+      </warning>
+
       <para>A configuration file can be generated by
 	<application>&xorg;</application> based on the detected
 	hardware.  This file is often a useful starting point for