Be more emphatic about not running -configure unless necessary.

This commit is contained in:
Warren Block 2017-01-29 16:14:25 +00:00
parent 5234784362
commit 094fa91fd8
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=49905

View file

@ -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