From owner-svn-doc-head@freebsd.org  Sun Jan 29 16:14:26 2017
Return-Path: <owner-svn-doc-head@freebsd.org>
Delivered-To: svn-doc-head@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id C1210CC738B;
 Sun, 29 Jan 2017 16:14:26 +0000 (UTC)
 (envelope-from wblock@FreeBSD.org)
Received: from repo.freebsd.org (repo.freebsd.org
 [IPv6:2610:1c1:1:6068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 770D21AEA;
 Sun, 29 Jan 2017 16:14:26 +0000 (UTC)
 (envelope-from wblock@FreeBSD.org)
Received: from repo.freebsd.org ([127.0.1.37])
 by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v0TGEPPA058886;
 Sun, 29 Jan 2017 16:14:25 GMT (envelope-from wblock@FreeBSD.org)
Received: (from wblock@localhost)
 by repo.freebsd.org (8.15.2/8.15.2/Submit) id v0TGEPL7058885;
 Sun, 29 Jan 2017 16:14:25 GMT (envelope-from wblock@FreeBSD.org)
Message-Id: <201701291614.v0TGEPL7058885@repo.freebsd.org>
X-Authentication-Warning: repo.freebsd.org: wblock set sender to
 wblock@FreeBSD.org using -f
From: Warren Block <wblock@FreeBSD.org>
Date: Sun, 29 Jan 2017 16:14:25 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r49905 - head/en_US.ISO8859-1/books/handbook/x11
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-head@freebsd.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: SVN commit messages for the doc tree for head
 <svn-doc-head.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head/>
List-Post: <mailto:svn-doc-head@freebsd.org>
List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 29 Jan 2017 16:14:26 -0000

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