aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook/x11
diff options
context:
space:
mode:
authorWarren Block <wblock@FreeBSD.org>2017-01-29 16:14:25 +0000
committerWarren Block <wblock@FreeBSD.org>2017-01-29 16:14:25 +0000
commit094fa91fd8c897f3d75503ac92e19d88f9ee9821 (patch)
tree70838257ef38f4f4af63b8a710c09375d8a520d4 /en_US.ISO8859-1/books/handbook/x11
parent523478436248d0b7994e745b7b30f62a6d1c4778 (diff)
downloaddoc-094fa91fd8c897f3d75503ac92e19d88f9ee9821.tar.gz
doc-094fa91fd8c897f3d75503ac92e19d88f9ee9821.zip
Be more emphatic about not running -configure unless necessary.
Notes
Notes: svn path=/head/; revision=49905
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/x11')
-rw-r--r--en_US.ISO8859-1/books/handbook/x11/chapter.xml22
1 files changed, 19 insertions, 3 deletions
diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.xml b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
index 8d0877f49c..b1325fa3df 100644
--- a/en_US.ISO8859-1/books/handbook/x11/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
@@ -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