os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

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

Browse source 
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
1 changed files with 74 additions and 27 deletions

101
en_US.ISO8859-1/books/handbook/x11/chapter.xml
View file

@ -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>
</listitem>
<listitem>
<para>Intel: as of FreeBSD 9.1, 3D acceleration on most
<para>Intel: as of &os;&nbsp;9.3 and &os;&nbsp;10.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>
IvyBridge, is supported. Support for switching between X
and virtual consoles is provided by &man.vt.4;.</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>ATI/Radeon: 2D and 3D acceleration is supported on most
Radeon cards up to the HD6000 series.</para>
</listitem>
<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>
<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>