White space fix only. Translators can ignore.

This commit is contained in:
Dru Lavigne 2013-10-08 23:04:53 +00:00
parent ee54ccdf52
commit 057950e679
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=42907

View file

@ -27,7 +27,7 @@
<para>An installation of &os; using <para>An installation of &os; using
<application>bsdinstall</application> does not automatically <application>bsdinstall</application> does not automatically
install a graphical user interface. This chapter describes install a graphical user interface. This chapter describes
how to install and configure <application>&xorg;</application>, how to install and configure <application>&xorg;</application>,
which provides the open source X Window System used to provide which provides the open source X Window System used to provide
a graphical environment. It then describes how to find and a graphical environment. It then describes how to find and
@ -38,11 +38,12 @@
configures the <application>&xorg;</application> and offers configures the <application>&xorg;</application> and offers
a choice of window managers during installation should a choice of window managers during installation should
refer to the <ulink refer to the <ulink
url="http://www.pcbsd.org/">pcbsd.org</ulink> website.</para> url="http://www.pcbsd.org/">pcbsd.org</ulink>
website.</para>
</note> </note>
<para>For more information on the video hardware that <application>&xorg;</application> <para>For more information on the video hardware that
supports, refer to the <application>&xorg;</application> supports, refer to the
<ulink url="http://www.x.org/">x.org</ulink> website.</para> <ulink url="http://www.x.org/">x.org</ulink> website.</para>
<para>After reading this chapter, you will know:</para> <para>After reading this chapter, you will know:</para>
@ -54,7 +55,8 @@
</listitem> </listitem>
<listitem> <listitem>
<para>How to install and configure <application>&xorg;</application>.</para> <para>How to install and configure
<application>&xorg;</application>.</para>
</listitem> </listitem>
<listitem> <listitem>
@ -63,7 +65,8 @@
</listitem> </listitem>
<listitem> <listitem>
<para>How to use &truetype; fonts in <application>&xorg;</application>.</para> <para>How to use &truetype; fonts in
<application>&xorg;</application>.</para>
</listitem> </listitem>
<listitem> <listitem>
@ -254,12 +257,12 @@
<note> <note>
<para>To build <application>&xorg;</application> in its <para>To build <application>&xorg;</application> in its
entirety, be sure to have at least 4&nbsp;GB of free disk space entirety, be sure to have at least 4&nbsp;GB of free disk
available.</para> space available.</para>
</note> </note>
<para>Alternatively, <application>&xorg;</application> can be installed directly from packages. <para>Alternatively, <application>&xorg;</application> can be
To install the package using installed directly from packages. To install the package using
<application>pkg_add</application>, type:</para> <application>pkg_add</application>, type:</para>
<screen>&prompt.root; <userinput>pkg_add -r xorg</userinput></screen> <screen>&prompt.root; <userinput>pkg_add -r xorg</userinput></screen>
@ -285,99 +288,99 @@
<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 self-configuring. Those with older <para>In most cases, <application>&xorg;</application> is
or unusual equipment may find it helpful to gather some self-configuring. Those with older or unusual equipment may
hardware information before beginning configuration.</para> find it helpful to gather some hardware information before
beginning configuration.</para>
<itemizedlist>
<listitem>
<para>Monitor sync frequencies</para>
</listitem>
<listitem>
<para>Video card chipset</para>
</listitem>
<listitem>
<para>Video card memory</para>
</listitem>
</itemizedlist>
<indexterm>
<primary>horizontal sync frequency</primary>
</indexterm>
<indexterm>
<primary>horizontal scan rate</primary>
<see>horizontal sync frequency</see>
</indexterm>
<indexterm><primary>refresh rate</primary></indexterm>
<indexterm>
<primary>vertical sync frequency</primary>
<see>refresh rate</see>
</indexterm>
<indexterm>
<primary>vertical scan rate</primary>
<see>refresh rate</see>
</indexterm>
<para>Screen resolution and refresh rate are determined by the
monitor's horizontal and vertical sync frequencies. Almost
all monitors support electronic autodetection of these values.
A few monitors do not provide these values, and the
specifications must be determined from the printed manual or
manufacturer web site.</para>
<para>The video card chipset is also autodetected, and used to
select the proper video driver. It is beneficial for the user
to be aware of which chipset is installed for when
autodetection does not provide the desired result.</para>
<para>Video card memory determines the maximum resolution and
color depth which can be displayed.</para>
<sect2>
<title>Caveats</title>
<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>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Monitor sync frequencies</para> <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>
<listitem> <listitem>
<para>Video card chipset</para> <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>
</listitem> </listitem>
<listitem> <listitem>
<para>Video card memory</para> <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>
</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>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</sect2>
<indexterm>
<primary>horizontal sync frequency</primary>
</indexterm>
<indexterm>
<primary>horizontal scan rate</primary>
<see>horizontal sync frequency</see>
</indexterm>
<indexterm><primary>refresh rate</primary></indexterm>
<indexterm>
<primary>vertical sync frequency</primary>
<see>refresh rate</see>
</indexterm>
<indexterm>
<primary>vertical scan rate</primary>
<see>refresh rate</see>
</indexterm>
<para>Screen resolution and refresh rate are determined by the
monitor's horizontal and vertical sync frequencies. Almost
all monitors support electronic autodetection of these values.
A few monitors do not provide these values, and the
specifications must be determined from the printed manual
or manufacturer web site.</para>
<para>The video card chipset is also autodetected, and used to
select the proper video driver. It is beneficial for the user
to be aware of which chipset is installed for when
autodetection does not provide the desired result.</para>
<para>Video card memory determines the maximum resolution and
color depth which can be displayed.</para>
<sect2>
<title>Caveats</title>
<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>
<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
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>
</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>
</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>
</listitem>
</itemizedlist>
</sect2>
<sect2> <sect2>
<title>Configuring <application>&xorg;</application></title> <title>Configuring <application>&xorg;</application></title>
@ -386,16 +389,16 @@
<acronym>HAL</acronym> to autodetect keyboards and mice. The <acronym>HAL</acronym> to autodetect keyboards and mice. The
<filename role="package">sysutils/hal</filename> and <filename role="package">sysutils/hal</filename> and
<filename role="package">devel/dbus</filename> ports are <filename role="package">devel/dbus</filename> ports are
automatically installed as dependencies of automatically installed as dependencies of <filename
<filename role="package">x11/xorg</filename>, but must be role="package">x11/xorg</filename>, but must be enabled by
enabled by adding the following entries to adding the following entries to
<filename>/etc/rc.conf</filename>:</para> <filename>/etc/rc.conf</filename>:</para>
<programlisting>hald_enable="YES" <programlisting>hald_enable="YES"
dbus_enable="YES"</programlisting> dbus_enable="YES"</programlisting>
<para>Start these services <para>Start these services before configuring
before configuring <application>&xorg;</application>:</para> <application>&xorg;</application>:</para>
<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>
@ -407,11 +410,10 @@ dbus_enable="YES"</programlisting>
<screen>&prompt.root; <userinput>Xorg -configure</userinput></screen> <screen>&prompt.root; <userinput>Xorg -configure</userinput></screen>
<para>This will generate a file named <para>This will generate a file named
<filename>/root/xorg.conf.new</filename> which attempts <filename>/root/xorg.conf.new</filename> which attempts to
to load the proper drivers for the load the proper drivers for the detected hardware. Next,
detected hardware. Next, test that the automatically generated test that the automatically generated configuration file
configuration file works with the graphics hardware by works with the graphics hardware by typing:</para>
typing:</para>
<screen>&prompt.root; <userinput>Xorg -config xorg.conf.new -retro</userinput></screen> <screen>&prompt.root; <userinput>Xorg -config xorg.conf.new -retro</userinput></screen>
@ -470,22 +472,21 @@ dbus_enable="YES"</programlisting>
<programlisting>Option "DontZap" "off"</programlisting> <programlisting>Option "DontZap" "off"</programlisting>
</note> </note>
<para>If the test is unsuccessful, skip ahead to <xref <para>If the test is unsuccessful, skip ahead to <xref
linkend="x11-understanding"/>. Once the test is successful, linkend="x11-understanding"/>. Once the test is successful,
copy the configuration file to copy the configuration file to
<filename>/etc/X11/xorg.conf</filename>:</para> <filename>/etc/X11/xorg.conf</filename>:</para>
<screen>&prompt.root; <userinput>cp xorg.conf.new /etc/X11/xorg.conf</userinput></screen> <screen>&prompt.root; <userinput>cp xorg.conf.new /etc/X11/xorg.conf</userinput></screen>
<note> <note>
<para>Desktop environments like <para>Desktop environments like
<application>GNOME</application>, <application>GNOME</application>,
<application>KDE</application> or <application>KDE</application> or
<application>Xfce</application> provide graphical tools <application>Xfce</application> provide graphical tools
to set parameters such as video resolution. to set parameters such as video resolution. If the default
If the default configuration works, skip to <xref linkend="x11-wm"/> configuration works, skip to <xref linkend="x11-wm"/>
for examples on how to for examples on how to install a desktop environment.</para>
install a desktop environment.</para>
</note> </note>
</sect2> </sect2>
</sect1> </sect1>
@ -505,24 +506,26 @@ dbus_enable="YES"</programlisting>
<sect2 id="type1"> <sect2 id="type1">
<title>Type1 Fonts</title> <title>Type1 Fonts</title>
<para>The default fonts that ship with <application>&xorg;</application> are less than ideal <para>The default fonts that ship with
for typical desktop publishing applications. Large <application>&xorg;</application> are less than ideal for
presentation fonts show up jagged and unprofessional looking, typical desktop publishing applications. Large presentation
and small fonts are almost completely unintelligible. fonts show up jagged and unprofessional looking, and small
However, there are several free, high quality Type1 fonts are almost completely unintelligible. However, there
(&postscript;) fonts available which can be readily used with are several free, high quality Type1 (&postscript;) fonts
<application>&xorg;</application>. For instance, the URW font collection available which can be readily used with
(<filename role="package">x11-fonts/urwfonts</filename>) <application>&xorg;</application>. For instance, the URW
includes high quality versions of standard type1 fonts font collection (<filename
(<trademark class="registered">Times Roman</trademark>, role="package">x11-fonts/urwfonts</filename>) includes high
<trademark class="registered">Helvetica</trademark>, quality versions of standard type1 fonts (<trademark
<trademark class="registered">Palatino</trademark> and class="registered">Times Roman</trademark>, <trademark
others). The Freefonts collection class="registered">Helvetica</trademark>, <trademark
(<filename role="package">x11-fonts/freefonts</filename>) class="registered">Palatino</trademark> and others). The
includes many more fonts, but most of them are intended for Freefonts collection (<filename
use in graphics software such as the role="package">x11-fonts/freefonts</filename>) includes
<application>Gimp</application>, and are not complete enough many more fonts, but most of them are intended for use in
to serve as screen fonts. In addition, <application>&xorg;</application> can be configured graphics software such as the <application>Gimp</application>,
and are not complete enough to serve as screen fonts. In
addition, <application>&xorg;</application> can be configured
to use &truetype; fonts with a minimum of effort. For more to use &truetype; fonts with a minimum of effort. For more
details on this, see the &man.X.7; manual page or the details on this, see the &man.X.7; manual page or the
<link linkend="truetype">section on &truetype; <link linkend="truetype">section on &truetype;
@ -587,20 +590,21 @@ dbus_enable="YES"</programlisting>
copy all of the &truetype; fonts into this directory. Keep in copy all of the &truetype; fonts into this directory. Keep in
mind that &truetype; fonts cannot be directly taken from a mind that &truetype; fonts cannot be directly taken from a
&macintosh;; they must be in &unix;/&ms-dos;/&windows; format &macintosh;; they must be in &unix;/&ms-dos;/&windows; format
for use by <application>&xorg;</application>. Once the files have been copied into this for use by <application>&xorg;</application>. Once the
directory, use <application>ttmkfdir</application> to create a files have been copied into this directory, use
<application>ttmkfdir</application> to create a
<filename>fonts.dir</filename> file, so that the X font <filename>fonts.dir</filename> file, so that the X font
renderer knows that these new files have been installed. renderer knows that these new files have been installed.
<command>ttmkfdir</command> is available from the FreeBSD <command>ttmkfdir</command> is available from the FreeBSD
Ports Collection as Ports Collection as <filename
<filename role="package">x11-fonts/ttmkfdir</filename>.</para> role="package">x11-fonts/ttmkfdir</filename>.</para>
<screen>&prompt.root; <userinput>cd /usr/local/lib/X11/fonts/TrueType</userinput> <screen>&prompt.root; <userinput>cd /usr/local/lib/X11/fonts/TrueType</userinput>
&prompt.root; <userinput>ttmkfdir -o fonts.dir</userinput></screen> &prompt.root; <userinput>ttmkfdir -o fonts.dir</userinput></screen>
<para>Now add the &truetype; directory to the font path. This <para>Now add the &truetype; directory to the font path. This
is just the same as described above for is just the same as described above for <link
<link linkend="type1">Type1</link> fonts, that is, use</para> linkend="type1">Type1</link> fonts, that is, use</para>
<screen>&prompt.user; <userinput>xset fp+ /usr/local/lib/X11/fonts/TrueType</userinput> <screen>&prompt.user; <userinput>xset fp+ /usr/local/lib/X11/fonts/TrueType</userinput>
&prompt.user; <userinput>xset fp rehash</userinput></screen> &prompt.user; <userinput>xset fp rehash</userinput></screen>
@ -637,8 +641,8 @@ dbus_enable="YES"</programlisting>
<secondary>anti-aliased</secondary> <secondary>anti-aliased</secondary>
</indexterm> </indexterm>
<para>All fonts in <application>&xorg;</application> that are found in <para>All fonts in <application>&xorg;</application> that are
<filename>/usr/local/lib/X11/fonts/</filename> and found in <filename>/usr/local/lib/X11/fonts/</filename> and
<filename>~/.fonts/</filename> are automatically made <filename>~/.fonts/</filename> are automatically made
available for anti-aliasing to Xft-aware applications. Most available for anti-aliasing to Xft-aware applications. Most
recent applications are Xft-aware, including recent applications are Xft-aware, including
@ -1465,19 +1469,19 @@ DisplayManager.requestPort: 0</screen>
</sect2> </sect2>
</sect1> </sect1>
<sect1 id="x11-understanding"> <sect1 id="x11-understanding">
<title>Troubleshooting</title> <title>Troubleshooting</title>
<para>If the mouse does not work, you will need to first <para>If the mouse does not work, you will need to first
configure it before proceeding. See <xref linkend="mouse"/> configure it before proceeding. See <xref linkend="mouse"/>
in the &os; install chapter. In recent in the &os; install chapter. In recent
<application>Xorg</application> versions, <application>Xorg</application> versions, the
the <literal>InputDevice</literal> sections in <literal>InputDevice</literal> sections in
<filename>xorg.conf</filename> are ignored in favor of the <filename>xorg.conf</filename> are ignored in favor of the
autodetected devices. To restore the old behavior, add the autodetected devices. To restore the old behavior, add the
following line to the <literal>ServerLayout</literal> or following line to the <literal>ServerLayout</literal> or
<literal>ServerFlags</literal> section of this file:</para> <literal>ServerFlags</literal> section of this file:</para>
<programlisting>Option "AutoAddDevices" "false"</programlisting> <programlisting>Option "AutoAddDevices" "false"</programlisting>
@ -1534,7 +1538,8 @@ DisplayManager.requestPort: 0</screen>
available.</para> available.</para>
</note> </note>
<indexterm><primary><application>&xorg;</application> tuning</primary></indexterm> <indexterm><primary><application>&xorg;</application>
tuning</primary></indexterm>
<para>The <filename>xorg.conf.new</filename> configuration file <para>The <filename>xorg.conf.new</filename> configuration file
may now be tuned to taste. Open the file in a text editor may now be tuned to taste. Open the file in a text editor
@ -1603,8 +1608,10 @@ EndSection</programlisting>
<note> <note>
<para>One of the tools available to assist you during <para>One of the tools available to assist you during
troubleshooting process are the <application>&xorg;</application> log files, which contain troubleshooting process are the
information on each device that the <application>&xorg;</application> server attaches to. <application>&xorg;</application> log files, which contain
information on each device that the
<application>&xorg;</application> server attaches to.
<application>&xorg;</application> log file names are in the <application>&xorg;</application> log file names are in the
format of <filename>/var/log/Xorg.0.log</filename>. The format of <filename>/var/log/Xorg.0.log</filename>. The
exact name of the log can vary from exact name of the log can vary from
@ -1619,9 +1626,10 @@ EndSection</programlisting>
<screen>&prompt.root; <userinput>cp xorg.conf.new /etc/X11/xorg.conf</userinput></screen> <screen>&prompt.root; <userinput>cp xorg.conf.new /etc/X11/xorg.conf</userinput></screen>
<para>The <application>&xorg;</application> configuration process is now complete. <para>The <application>&xorg;</application> configuration
<application>&xorg;</application> may be now started with the process is now complete. <application>&xorg;</application>
&man.startx.1; utility. The <application>&xorg;</application> server may also be started may be now started with the &man.startx.1; utility. The
<application>&xorg;</application> server may also be started
with the use of &man.xdm.1;.</para> with the use of &man.xdm.1;.</para>
<sect2> <sect2>
@ -1634,8 +1642,9 @@ EndSection</programlisting>
<para>Configuration with &intel; i810 integrated chipsets <para>Configuration with &intel; i810 integrated chipsets
requires the <devicename>agpgart</devicename> AGP requires the <devicename>agpgart</devicename> AGP
programming interface for <application>&xorg;</application> to drive the card. See the programming interface for <application>&xorg;</application>
&man.agp.4; driver manual page for more information.</para> to drive the card. See the &man.agp.4; driver manual page
for more information.</para>
<para>This will allow configuration of the hardware as any <para>This will allow configuration of the hardware as any
other graphics board. Note on systems without the other graphics board. Note on systems without the
@ -1741,6 +1750,6 @@ EndSection</programlisting>
<para>Now having completed these simple editing steps, X <para>Now having completed these simple editing steps, X
should start on your new widescreen monitor.</para> should start on your new widescreen monitor.</para>
</sect2> </sect2>
</sect1> </sect1>
</chapter> </chapter>