Date: Sun, 29 Jan 2017 16:14:25 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> 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 Message-ID: <201701291614.v0TGEPL7058885@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201701291614.v0TGEPL7058885>