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

Warren Block <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]>
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
_______________________________________________
[email protected] mailing list
https://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.