Date: Sun, 26 Jul 2015 10:23:03 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47098 - head/en_US.ISO8859-1/books/handbook/x11 Message-ID: <201507261023.t6QAN3HO068963@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201507261023.t6QAN3HO068963>