svn commit: r46018 - head/en_US.ISO8859-1/books/handbook/x11

Author: wblock
Date: Mon Nov 24 02:15:39 2014
New Revision: 46018
URL: https://svnweb.freebsd.org/changeset/doc/46018

Log:
  Add a quick start that shows starting X without a configuration file.
  Update the explanation of which graphics cards are supported.

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 Nov 23 15:00:45 2014	(r46017)
+++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Mon Nov 24 02:15:39 2014	(r46018)
@@ -266,6 +266,59 @@
     <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/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>
@@ -283,8 +336,7 @@
     <indexterm><primary>&xorg;</primary></indexterm>
     <indexterm><primary><application>&xorg;</application></primary></indexterm>
 
-    <para>In most cases, <application>&xorg;</application> is
-      self-configuring.  Those with older or unusual equipment may
+    <para>Those with older or unusual equipment may
       find it helpful to gather some hardware information before
       beginning configuration.</para>
 
@@ -339,40 +391,35 @@
 
       <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>
+	driver.  At this time, driver support includes:</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>
+	  <para>Intel: as of &os;&nbsp;9.3 and &os;&nbsp;10.1, 3D acceleration on most
+	    Intel graphics, including IronLake, SandyBridge, and
+	    IvyBridge, is supported.  Support for switching between X
+	    and virtual consoles is provided by &man.vt.4;.</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>
+	  <para>ATI/Radeon: 2D and 3D acceleration is supported on most
+	    Radeon cards up to the HD6000 series.</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>
+	  <para>NVIDIA: several NVIDIA drivers are available in the
+	    <filename>x11</filename> category of the Ports Collection.  Install
+	    the driver that matches the video card.</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>
+	    Optimus implementations vary, and &os; will not
+	    be able to drive all versions of the
+	    hardware.  Some computers provide a <acronym>BIOS</acronym>
+	    option to disable one of the graphics adapters or
+	    select a <emphasis>discrete</emphasis> mode.</para>
 	</listitem>
       </itemizedlist>
     </sect2>
@@ -380,12 +427,12 @@
     <sect2>
       <title>Configuring <application>&xorg;</application></title>
 
-      <para><application>&xorg;</application> uses
+      <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 the following entries to
+	must be enabled by adding these entries to
 	<filename>/etc/rc.conf</filename>:</para>
 
       <programlisting>hald_enable="YES"
@@ -397,7 +444,7 @@ dbus_enable="YES"</programlisting>
       <screen>&prompt.root; <userinput>service hald start</userinput>
 &prompt.root; <userinput>service dbus start</userinput></screen>
 
-      <para>Once these services are started, check if
+      <para>Once the services have been started, check whether
 	<application>&xorg;</application> auto-configures itself by
 	typing:</para>
 
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"