Add a quick start that shows starting X without a configuration file.

Update the explanation of which graphics cards are supported.
This commit is contained in:
Warren Block 2014-11-24 02:15:39 +00:00
parent f7ae046cda
commit 8b83e67420
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=46018

View file

@ -266,6 +266,59 @@
<screen>&prompt.root; <userinput>pkg install xorg</userinput></screen> <screen>&prompt.root; <userinput>pkg install xorg</userinput></screen>
</sect1> </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"> <sect1 xml:id="x-config">
<!-- <!--
<sect1info> <sect1info>
@ -283,8 +336,7 @@
<indexterm><primary>&xorg;</primary></indexterm> <indexterm><primary>&xorg;</primary></indexterm>
<indexterm><primary><application>&xorg;</application></primary></indexterm> <indexterm><primary><application>&xorg;</application></primary></indexterm>
<para>In most cases, <application>&xorg;</application> is <para>Those with older or unusual equipment may
self-configuring. Those with older or unusual equipment may
find it helpful to gather some hardware information before find it helpful to gather some hardware information before
beginning configuration.</para> beginning configuration.</para>
@ -339,40 +391,35 @@
<para>The ability to configure optimal resolution is dependent <para>The ability to configure optimal resolution is dependent
upon the video hardware and the support provided by its 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> <itemizedlist>
<listitem> <listitem>
<para>NVIDIA: several NVIDIA drivers are available in the <para>Intel: as of &os;&nbsp;9.3 and &os;&nbsp;10.1, 3D acceleration on most
x11 category of the FreeBSD Ports Collection. Install
the driver that matches the model of the NVIDIA
hardware.</para>
</listitem>
<listitem>
<para>Intel: as of FreeBSD 9.1, 3D acceleration on most
Intel graphics, including IronLake, SandyBridge, and Intel graphics, including IronLake, SandyBridge, and
IvyBridge, is supported. Due to the current KMS IvyBridge, is supported. Support for switching between X
implementation, it is not possible to switch between the and virtual consoles is provided by &man.vt.4;.</para>
graphical console and a virtual console using
Crtl+Alt+F#.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>ATI/Radeon: 3D acceleration will not work on ATI or <para>ATI/Radeon: 2D and 3D acceleration is supported on most
Radeon cards until FreeBSD completes its TTM work. These Radeon cards up to the HD6000 series.</para>
cards will need to be configured with the 2D driver, and </listitem>
if that does not work, with the Vesa driver.</para>
<listitem>
<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>
<listitem> <listitem>
<para>Optimus: currently there is no switching support <para>Optimus: currently there is no switching support
between the two graphics adapters provided by Optimus. between the two graphics adapters provided by Optimus.
Optimus implementations vary, so FreeBSD may or may not Optimus implementations vary, and &os; will not
be able to successfully load a graphics driver on all be able to drive all versions of the
hardware. If you get a blank screen, check if the BIOS hardware. Some computers provide a <acronym>BIOS</acronym>
has an option to disable one of the graphics adapters or option to disable one of the graphics adapters or
to set <quote>discrete</quote> mode.</para> select a <emphasis>discrete</emphasis> mode.</para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</sect2> </sect2>
@ -380,12 +427,12 @@
<sect2> <sect2>
<title>Configuring <application>&xorg;</application></title> <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 <acronym>HAL</acronym> to autodetect keyboards and mice. The
<package>sysutils/hal</package> and <package>sysutils/hal</package> and
<package>devel/dbus</package> ports are automatically <package>devel/dbus</package> ports are automatically
installed as dependencies of <package>x11/xorg</package>, but 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> <filename>/etc/rc.conf</filename>:</para>
<programlisting>hald_enable="YES" <programlisting>hald_enable="YES"
@ -397,7 +444,7 @@ dbus_enable="YES"</programlisting>
<screen>&prompt.root; <userinput>service hald start</userinput> <screen>&prompt.root; <userinput>service hald start</userinput>
&prompt.root; <userinput>service dbus start</userinput></screen> &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 <application>&xorg;</application> auto-configures itself by
typing:</para> typing:</para>