svn commit: r47098 - head/en_US.ISO8859-1/books/handbook/x11
Dru Lavigne
dru at FreeBSD.org
Sun Jul 26 10:23:04 UTC 2015
Author: dru
Date: Sun Jul 26 10:23:02 2015
New Revision: 47098
URL: https://svnweb.freebsd.org/changeset/doc/47098
Log:
White space fix only. Translators can ignore.
Sponsored by: Essen DevSummit Hackathon
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 Jul 26 10:15:23 2015 (r47097)
+++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Sun Jul 26 10:23:02 2015 (r47098)
@@ -266,59 +266,6 @@
<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/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">
<!--
<sect1info>
@@ -336,55 +283,77 @@ dbus_enable="YES"</programlisting>
<indexterm><primary>&xorg;</primary></indexterm>
<indexterm><primary><application>&xorg;</application></primary></indexterm>
- <para>Those with older or unusual equipment may 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>In most cases, <application>&xorg;</application> is
+ self-configuring. Autoconfiguration is the preferred method,
+ 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>
+
+ <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>
+
+ <para>To generate the configuration file and start the X system,
+ issue this command:</para>
+
+ <screen>&prompt.user; <userinput>startx</userinput></screen>
+
+ <para>If a black and grey grid and an X mouse cursor appear, the
+ configuration was successful. Test the system by moving the
+ mouse and typing text into the windows. 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>
+
+ <para>If the mouse or keyboard do not work, continue with <xref
+ linkend="x11-understanding"/>.</para>
- <para>Video card memory determines the maximum resolution and
- color depth which can be displayed.</para>
+ <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>
+ <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>
<title>Caveats</title>
@@ -424,106 +393,6 @@ dbus_enable="YES"</programlisting>
</listitem>
</itemizedlist>
</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 xml:id="x-fonts">
More information about the svn-doc-all
mailing list