svn commit: r46018 - head/en_US.ISO8859-1/books/handbook/x11
Warren Block
wblock at FreeBSD.org
Mon Nov 24 02:15:40 UTC 2014
Author: wblock
Date: Mon Nov 24 02:15:39 2014
New Revision: 46018
URL: https://svnweb.freebsd.org/changeset/doc/46018
Log:
Add a quick start that shows starting X without a configuration file.
Update the explanation of which graphics cards are supported.
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 Nov 23 15:00:45 2014 (r46017)
+++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Mon Nov 24 02:15:39 2014 (r46018)
@@ -266,6 +266,59 @@
<screen>&prompt.root; <userinput>pkg install xorg</userinput></screen>
</sect1>
+ <sect1 xml:id="x-config-quick-start">
+ <title>Quick Start</title>
+
+ <para>In most cases, <application>&xorg;</application> is
+ self-configuring. When started without any configuration file,
+ the video card and input devices are automatically detected and
+ used. Autoconfiguration is the preferred method, and should be
+ tried first.</para>
+
+ <procedure xml:id="x-config-quick-start-procedure">
+ <step>
+ <para>Check if <acronym>HAL</acronym> is used by the X
+ server:</para>
+
+ <screen>&prompt.user; <userinput>pkg info xorg-server | grep HAL</userinput></screen>
+
+ <para>If the output shows <acronym>HAL</acronym> is
+ <literal>off</literal>, skip to the next step. If
+ <acronym>HAL</acronym> is <literal>on</literal>, enable
+ needed services by adding two entries to
+ <filename>/etc/rc.conf</filename>. Then start the
+ services:</para>
+
+ <programlisting>hald_enable="YES"
+dbus_enable="YES"</programlisting>
+
+ <screen>&prompt.root; <userinput>service hald start ; service dbus start</userinput></screen>
+ </step>
+
+ <step>
+ <para>Rename or delete old versions of
+ <filename>xorg.conf</filename>:</para>
+
+ <screen>&prompt.root; <userinput>mv /etc/xorg.conf ~/xorg.conf.etc</userinput>
+&prompt.root; <userinput>mv /usr/local/etc/X11/xorg.conf ~/xorg.conf.localetc</userinput></screen>
+ </step>
+
+ <step>
+ <para>Start the X system:</para>
+
+ <screen>&prompt.user; <userinput>startx</userinput></screen>
+
+ <para>Test the system by moving the mouse and typing text into
+ the windows. If both mouse and keyboard work as expected,
+ see <xref linkend="x11-wm"/> and
+ <xref linkend="x-xdm"/>.</para>
+
+ <para>If the mouse or keyboard do not work, continue with
+ <xref linkend="x-config"/>.</para>
+ </step>
+ </procedure>
+ </sect1>
+
<sect1 xml:id="x-config">
<!--
<sect1info>
@@ -283,8 +336,7 @@
<indexterm><primary>&xorg;</primary></indexterm>
<indexterm><primary><application>&xorg;</application></primary></indexterm>
- <para>In most cases, <application>&xorg;</application> is
- self-configuring. Those with older or unusual equipment may
+ <para>Those with older or unusual equipment may
find it helpful to gather some hardware information before
beginning configuration.</para>
@@ -339,40 +391,35 @@
<para>The ability to configure optimal resolution is dependent
upon the video hardware and the support provided by its
- driver. At this time, driver support is as follows:</para>
+ driver. At this time, driver support includes:</para>
<itemizedlist>
<listitem>
- <para>NVIDIA: several NVIDIA drivers are available in the
- x11 category of the FreeBSD Ports Collection. Install
- the driver that matches the model of the NVIDIA
- hardware.</para>
+ <para>Intel: as of &os; 9.3 and &os; 10.1, 3D acceleration on most
+ Intel graphics, including IronLake, SandyBridge, and
+ IvyBridge, is supported. Support for switching between X
+ and virtual consoles is provided by &man.vt.4;.</para>
</listitem>
<listitem>
- <para>Intel: as of FreeBSD 9.1, 3D acceleration on most
- Intel graphics, including IronLake, SandyBridge, and
- IvyBridge, is supported. Due to the current KMS
- implementation, it is not possible to switch between the
- graphical console and a virtual console using
- Crtl+Alt+F#.</para>
+ <para>ATI/Radeon: 2D and 3D acceleration is supported on most
+ Radeon cards up to the HD6000 series.</para>
</listitem>
<listitem>
- <para>ATI/Radeon: 3D acceleration will not work on ATI or
- Radeon cards until FreeBSD completes its TTM work. These
- cards will need to be configured with the 2D driver, and
- if that does not work, with the Vesa driver.</para>
+ <para>NVIDIA: several NVIDIA drivers are available in the
+ <filename>x11</filename> category of the Ports Collection. Install
+ the driver that matches the video card.</para>
</listitem>
<listitem>
<para>Optimus: currently there is no switching support
between the two graphics adapters provided by Optimus.
- Optimus implementations vary, so FreeBSD may or may not
- be able to successfully load a graphics driver on all
- hardware. If you get a blank screen, check if the BIOS
- has an option to disable one of the graphics adapters or
- to set <quote>discrete</quote> mode.</para>
+ Optimus implementations vary, and &os; will not
+ be able to drive all versions of the
+ hardware. Some computers provide a <acronym>BIOS</acronym>
+ option to disable one of the graphics adapters or
+ select a <emphasis>discrete</emphasis> mode.</para>
</listitem>
</itemizedlist>
</sect2>
@@ -380,12 +427,12 @@
<sect2>
<title>Configuring <application>&xorg;</application></title>
- <para><application>&xorg;</application> uses
+ <para>By default, <application>&xorg;</application> uses
<acronym>HAL</acronym> to autodetect keyboards and mice. The
<package>sysutils/hal</package> and
<package>devel/dbus</package> ports are automatically
installed as dependencies of <package>x11/xorg</package>, but
- must be enabled by adding the following entries to
+ must be enabled by adding these entries to
<filename>/etc/rc.conf</filename>:</para>
<programlisting>hald_enable="YES"
@@ -397,7 +444,7 @@ dbus_enable="YES"</programlisting>
<screen>&prompt.root; <userinput>service hald start</userinput>
&prompt.root; <userinput>service dbus start</userinput></screen>
- <para>Once these services are started, check if
+ <para>Once the services have been started, check whether
<application>&xorg;</application> auto-configures itself by
typing:</para>
More information about the svn-doc-head
mailing list