Date: Mon, 24 Nov 2014 02:15:40 +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: r46018 - head/en_US.ISO8859-1/books/handbook/x11 Message-ID: <201411240215.sAO2FeUL032067@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201411240215.sAO2FeUL032067>