White space fix only. Translators can ignore.
Sponsored by: Essen DevSummit Hackathon
This commit is contained in:
Dru Lavigne
parent
47b04bf6db
commit
3af9c4c0e8
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=47098
1 changed files with 64 additions and 195 deletions
|
|
@ -266,59 +266,6 @@
|
||||||
<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/X11/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>
|
||||||
|
|
@ -336,55 +283,77 @@ dbus_enable="YES"</programlisting>
|
||||||
<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>Those with older or unusual equipment may find it helpful to
|
<para>In most cases, <application>&xorg;</application> is
|
||||||
gather some hardware information before beginning
|
self-configuring. Autoconfiguration is the preferred method,
|
||||||
configuration.</para>
|
and should be tried first. When X is started without a
|
||||||
|
configuration file, the video card and input devices are
|
||||||
|
automatically detected and used. If the system already has a
|
||||||
|
configuration file and you wish to create a new configuration,
|
||||||
|
save a copy of the old one first:</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<screen>&prompt.root; <userinput>mv /etc/X11/xorg.conf ~/xorg.conf.etc</userinput>
|
||||||
<listitem>
|
&prompt.root; <userinput>mv /usr/local/etc/X11/xorg.conf ~/xorg.conf.localetc</userinput></screen>
|
||||||
<para>Monitor sync frequencies</para>
|
|
||||||
</listitem>
|
|
||||||
|
|
||||||
<listitem>
|
<para>To generate the configuration file and start the X system,
|
||||||
<para>Video card chipset</para>
|
issue this command:</para>
|
||||||
</listitem>
|
|
||||||
|
|
||||||
<listitem>
|
<screen>&prompt.user; <userinput>startx</userinput></screen>
|
||||||
<para>Video card memory</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
|
|
||||||
<indexterm>
|
<para>If a black and grey grid and an X mouse cursor appear, the
|
||||||
<primary>horizontal sync frequency</primary>
|
configuration was successful. Test the system by moving the
|
||||||
</indexterm>
|
mouse and typing text into the windows. To exit the test,
|
||||||
<indexterm>
|
switch to the virtual console used to start it by pressing
|
||||||
<primary>horizontal scan rate</primary>
|
<keycombo action="simul"> <keycap>Ctrl</keycap>
|
||||||
<see>horizontal sync frequency</see>
|
<keycap>Alt</keycap>
|
||||||
</indexterm>
|
<keycap>F<replaceable>n</replaceable></keycap> </keycombo>
|
||||||
<indexterm><primary>refresh rate</primary></indexterm>
|
(<keycap>F1</keycap> for the first virtual console) and press
|
||||||
<indexterm>
|
<keycombo action="simul"> <keycap>Ctrl</keycap>
|
||||||
<primary>vertical sync frequency</primary>
|
<keycap>C</keycap> </keycombo>.</para>
|
||||||
<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
|
<para>If the mouse or keyboard do not work, continue with <xref
|
||||||
monitor's horizontal and vertical sync frequencies. Almost all
|
linkend="x11-understanding"/>.</para>
|
||||||
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
|
<para>Desktop environments like <application>GNOME</application>,
|
||||||
select the proper video driver. It is beneficial for the user
|
<application>KDE</application> or
|
||||||
to be aware of which chipset is installed for when autodetection
|
<application>Xfce</application> provide graphical tools to set
|
||||||
does not provide the desired result.</para>
|
parameters such as video resolution. If the default
|
||||||
|
configuration works, skip to <xref linkend="x11-wm"/> for
|
||||||
|
examples on how to install a desktop environment.</para>
|
||||||
|
|
||||||
<para>Video card memory determines the maximum resolution and
|
<note>
|
||||||
color depth which can be displayed.</para>
|
<para>The <keycombo action="simul">
|
||||||
|
<keycap>Ctrl</keycap>
|
||||||
|
<keycap>Alt</keycap>
|
||||||
|
<keycap>Backspace</keycap>
|
||||||
|
</keycombo> key combination may also be used to break out of
|
||||||
|
<application>&xorg;</application>. To enable it, you can
|
||||||
|
either type the following command from any X terminal
|
||||||
|
emulator:</para>
|
||||||
|
|
||||||
|
<screen>&prompt.user; <userinput>setxkbmap -option terminate:ctrl_alt_bksp</userinput></screen>
|
||||||
|
|
||||||
|
<para>or create a keyboard configuration file for
|
||||||
|
<application>hald</application> called
|
||||||
|
<filename>x11-input.fdi</filename> and saved in the
|
||||||
|
<filename>/usr/local/etc/hal/fdi/policy</filename> directory.
|
||||||
|
This file should contain the following lines:</para>
|
||||||
|
|
||||||
|
<programlisting><?xml version="1.0" encoding="iso-8859-1"?>
|
||||||
|
<deviceinfo version="0.2">
|
||||||
|
<device>
|
||||||
|
<match key="info.capabilities" contains="input.keyboard">
|
||||||
|
<merge key="input.x11_options.XkbOptions" type="string">terminate:ctrl_alt_bksp</merge>
|
||||||
|
</match>
|
||||||
|
</device>
|
||||||
|
</deviceinfo></programlisting>
|
||||||
|
|
||||||
|
<para>The following line will also have to be added to
|
||||||
|
<filename>xorg.conf.new</filename>, in the
|
||||||
|
<literal>ServerLayout</literal> or
|
||||||
|
<literal>ServerFlags</literal> section:</para>
|
||||||
|
|
||||||
|
<programlisting>Option "DontZap" "off"</programlisting>
|
||||||
|
</note>
|
||||||
|
|
||||||
<sect2>
|
<sect2>
|
||||||
<title>Caveats</title>
|
<title>Caveats</title>
|
||||||
|
|
@ -424,106 +393,6 @@ dbus_enable="YES"</programlisting>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2>
|
|
||||||
<title>Configuring <application>&xorg;</application></title>
|
|
||||||
|
|
||||||
<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 these entries to
|
|
||||||
<filename>/etc/rc.conf</filename>:</para>
|
|
||||||
|
|
||||||
<programlisting>hald_enable="YES"
|
|
||||||
dbus_enable="YES"</programlisting>
|
|
||||||
|
|
||||||
<para>Start these services before configuring
|
|
||||||
<application>&xorg;</application>:</para>
|
|
||||||
|
|
||||||
<screen>&prompt.root; <userinput>service hald start</userinput>
|
|
||||||
&prompt.root; <userinput>service dbus start</userinput></screen>
|
|
||||||
|
|
||||||
<para>Once the services have been started, check whether
|
|
||||||
<application>&xorg;</application> auto-configures itself by
|
|
||||||
typing:</para>
|
|
||||||
|
|
||||||
<screen>&prompt.root; <userinput>Xorg -configure</userinput></screen>
|
|
||||||
|
|
||||||
<para>This will generate a file named
|
|
||||||
<filename>/root/xorg.conf.new</filename> which attempts to
|
|
||||||
load the proper drivers for the detected hardware. Next, test
|
|
||||||
that the automatically generated configuration file works with
|
|
||||||
the graphics hardware by typing:</para>
|
|
||||||
|
|
||||||
<screen>&prompt.root; <userinput>Xorg -config xorg.conf.new -retro</userinput></screen>
|
|
||||||
|
|
||||||
<para>If a black and grey grid and an X mouse cursor appear, the
|
|
||||||
configuration was successful. To exit the test, switch to the
|
|
||||||
virtual console used to start it by pressing <keycombo
|
|
||||||
action="simul"> <keycap>Ctrl</keycap> <keycap>Alt</keycap>
|
|
||||||
<keycap>F<replaceable>n</replaceable></keycap> </keycombo>
|
|
||||||
(<keycap>F1</keycap> for the first virtual console) and press
|
|
||||||
<keycombo action="simul"> <keycap>Ctrl</keycap>
|
|
||||||
<keycap>C</keycap> </keycombo>.</para>
|
|
||||||
|
|
||||||
<note>
|
|
||||||
<para>The <keycombo action="simul">
|
|
||||||
<keycap>Ctrl</keycap>
|
|
||||||
<keycap>Alt</keycap>
|
|
||||||
<keycap>Backspace</keycap>
|
|
||||||
</keycombo> key combination may also be used to break out of
|
|
||||||
<application>&xorg;</application>. To enable it, you can
|
|
||||||
either type the following command from any X terminal
|
|
||||||
emulator:</para>
|
|
||||||
|
|
||||||
<screen>&prompt.user; <userinput>setxkbmap -option terminate:ctrl_alt_bksp</userinput></screen>
|
|
||||||
|
|
||||||
<para>or create a keyboard configuration file for
|
|
||||||
<application>hald</application> called
|
|
||||||
<filename>x11-input.fdi</filename> and saved in the
|
|
||||||
<filename>/usr/local/etc/hal/fdi/policy</filename>
|
|
||||||
directory. This file should contain the following
|
|
||||||
lines:</para>
|
|
||||||
|
|
||||||
<programlisting><?xml version="1.0" encoding="iso-8859-1"?>
|
|
||||||
<deviceinfo version="0.2">
|
|
||||||
<device>
|
|
||||||
<match key="info.capabilities" contains="input.keyboard">
|
|
||||||
<merge key="input.x11_options.XkbOptions" type="string">terminate:ctrl_alt_bksp</merge>
|
|
||||||
</match>
|
|
||||||
</device>
|
|
||||||
</deviceinfo></programlisting>
|
|
||||||
|
|
||||||
<para>You will have to reboot your machine to force
|
|
||||||
<application>hald</application> to read this file.</para>
|
|
||||||
|
|
||||||
<para>The following line will also have to be added to
|
|
||||||
<filename>xorg.conf.new</filename>, in the
|
|
||||||
<literal>ServerLayout</literal> or
|
|
||||||
<literal>ServerFlags</literal> section:</para>
|
|
||||||
|
|
||||||
<programlisting>Option "DontZap" "off"</programlisting>
|
|
||||||
</note>
|
|
||||||
|
|
||||||
<para>If the test is unsuccessful, skip ahead to <xref
|
|
||||||
linkend="x11-understanding"/>. Once the test is successful,
|
|
||||||
copy the configuration file to
|
|
||||||
<filename>/etc/X11/xorg.conf</filename>:</para>
|
|
||||||
|
|
||||||
<screen>&prompt.root; <userinput>cp xorg.conf.new /etc/X11/xorg.conf</userinput></screen>
|
|
||||||
|
|
||||||
<note>
|
|
||||||
<para>Desktop environments like
|
|
||||||
<application>GNOME</application>,
|
|
||||||
<application>KDE</application> or
|
|
||||||
<application>Xfce</application> provide graphical tools to
|
|
||||||
set parameters such as video resolution. If the default
|
|
||||||
configuration works, skip to <xref linkend="x11-wm"/> for
|
|
||||||
examples on how to install a desktop environment.</para>
|
|
||||||
</note>
|
|
||||||
</sect2>
|
|
||||||
</sect1>
|
</sect1>
|
||||||
|
|
||||||
<sect1 xml:id="x-fonts">
|
<sect1 xml:id="x-fonts">
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue