Skip site navigation (1)Skip section navigation (2)
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>&lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
+&lt;deviceinfo version="0.2"&gt;
+  &lt;device&gt;
+    &lt;match key="info.capabilities" contains="input.keyboard"&gt;
+	  &lt;merge key="input.x11_options.XkbOptions" type="string"&gt;terminate:ctrl_alt_bksp&lt;/merge&gt;
+    &lt;/match&gt;
+  &lt;/device&gt;
+&lt;/deviceinfo&gt;</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>&lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;deviceinfo version="0.2"&gt;
-  &lt;device&gt;
-    &lt;match key="info.capabilities" contains="input.keyboard"&gt;
-	  &lt;merge key="input.x11_options.XkbOptions" type="string"&gt;terminate:ctrl_alt_bksp&lt;/merge&gt;
-    &lt;/match&gt;
-  &lt;/device&gt;
-&lt;/deviceinfo&gt;</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>