Author: bdubbs
Date: 2006-04-22 18:11:29 -0600 (Sat, 22 Apr 2006)
New Revision: 5914

Modified:
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/x/installing/x-config.xml
Log:
Updated  Additional X Window System Configuration section

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml       2006-04-22 23:42:29 UTC 
(rev 5913)
+++ trunk/BOOK/introduction/welcome/changelog.xml       2006-04-23 00:11:29 UTC 
(rev 5914)
@@ -45,6 +45,10 @@
       <para>April 22nd, 2006</para>
       <itemizedlist>
         <listitem>
+          <para>[bdubbs] - Updated  Additional X Window System Configuration
+          section.</para>
+        </listitem>
+        <listitem>
           <para>[randy] - Updated to ExtUtils-F77-1.15.</para>
         </listitem>
         <listitem>

Modified: trunk/BOOK/x/installing/x-config.xml
===================================================================
--- trunk/BOOK/x/installing/x-config.xml        2006-04-22 23:42:29 UTC (rev 
5913)
+++ trunk/BOOK/x/installing/x-config.xml        2006-04-23 00:11:29 UTC (rev 
5914)
@@ -16,24 +16,25 @@
   <title>Additional X Window System Configuration</title>
 
   <para>Below you will find information on fine tuning the components of both
-  variants of <application>X Window System</application>. The documentation
+  variants of the <application>X Window System</application>. The documentation
   links are specifically for <application>XFree86</application>, however, the
   information contained in those documents usually pertains to
-  <application>Xorg</application> as well.</para>
+  <application>Xorg</application> as well.  Detailed descripttions are also
+  located in the <filename>xorg.conf</filename> or
+  <filename>XF86Config</filename> man pages.</para>
 
-  <para condition="html" role="usernotes">User Notes:
-  <ulink url="&blfs-wiki;/InputMethods"/></para>
-
   <sect2 id='xinput'>
     <title>Setting up X Input Devices</title>
 
-    <para>This is a new section for BLFS. For now, here are some convenient
-    links for additional configuration of X input devices. Descriptive content
-    will be added soon.</para>
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/InputMethods"/></para>
 
     <sect3 id='xkeyboard'>
       <title>Keyboards</title>
 
+      <para>The following external links provide a good introduction
+      to setting up various keybords.</para>
+
       <para><ulink url="http://www.xfree86.org/current/XKB-Config.html";>The
       <application>XKB</application> Configuration Guide</ulink></para>
 
@@ -76,35 +77,124 @@
 
     </sect3>
 
-    <sect3 id='xinput-other'>
-      <title>Other</title>
-
-      <para>To be added...</para>
-
-    </sect3>
-
   </sect2>
 
-  <sect2>
+  <sect2 id='xdisplay'>
     <title>Fine Tuning Display Settings</title>
 
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/xdisplay"/></para>
+
     <sect3>
       <title>The 'Monitor' Section</title>
 
-      <para>To be added...</para>
+      <para>One or more monitor sections specify the charateristics of your
+      monitor(s).  Usually, the setup program can probe your monitor and setup
+      a monitor properly, however, this does not always work.  The most common
+      entries that need to be updated are <option>HorizSync</option> and
+      <option>VertRefresh</option>.  If the configuration program does not set
+      these properly, you will notice a resolution much lower than desired.
+      The default <option>HorizSync</option> setting is 28-33kHz which is very
+      conservative.  The default  <option>VertRefresh</option> is 43-72Hz.
+      Consult your monitor documentation or search on line for the proper
+      settings for your monitor.</para>
 
+      <para>It is also possible to control many detailed timing characteristics
+      of a monitor with a <option>Modeline</option> setting.  Most users will
+      not need to do this, but details are in the man page referenced above.
+      </para>
+
+      <warning><para>Incorrect monitor settings can destroy your monitor or
+      even set it on fire!  For most newer monitors, the result of overly
+      aggressive settings is a blank screen, but older monitors do not all have
+      built in safeguards.</para></warning>
+
+      <para>Other items that may be of interest in this section is the
+      <option>DPMS</option> and associated <option>StandbyTime</option>,
+      <option>SuspendTime</option>, and <option>OffTime</option> options.
+      These parameters control the enrgy saving features of your monitor.  They
+      may also be controled at runtime with the <command>xset</command> command
+      or via a graphical interface such as <application>KDE</application>'s
+      Control Center.</para>
+
+      <para>A typical monitor sections will normally look like:</para>
+
+<screen><literal>Section "Monitor"
+    DisplaySize   400   300 # mm
+    Identifier   "Monitor0"
+    VendorName   "VSC"
+    ModelName    "G810-2"
+    HorizSync     30.0 - 92.0
+    VertRefresh   50.0 - 180.0
+    Option       "DPMS"   
+    Option       "StandbyTime" "10"
+    Option       "SuspendTime" "20"
+    Option       "OffTime"     "30"
+EndSection</literal></screen>
+                
     </sect3>
 
     <sect3>
       <title>The 'Device' Section</title>
 
-      <para>To be added...</para>
+      <para>This section basically controls your video card. The key entry is
+      the <option>Driver</option> setting.  This can be a driver from the
+      <application>X</application> distribution you are using, from the kernel
+      source, or a proprietary driver for devices such as a Nvidia graphics
+      adaptor.  The driver often is a kernel module or built into the kernel
+      itself, but there are also separate non-kernal components usually found
+      in the <filename
+      class='directory'>/usr/X11R6/lib/modules/drivers/</filename> directory.
+      These were either built with the <application>X</application> server or
+      installed via external (e.g. proprietary) programs.</para>
 
-      <para><ulink
-      
url="http://www.xfree86.org/current/manindex4.html";>Devices</ulink></para>
+      <para>There are many options for device drivers and most are specific to
+      the driver being used.  Documentation for many drivers can be found at
+      the <ulink url="http://www.xfree86.org/current/manindex4.html";>XFree86
+      Driver Manual Pages</ulink>.</para>
 
+      <para>A typical Device section will look like:</para>
+
+<screen><literal>Section "Device"
+    Identifier  "Videocard0"
+    Driver      "radeon"
+    VendorName  "Videocard vendor"
+    BoardName   "ATI Radeon 7500"
+EndSection</literal></screen>
+
     </sect3>
 
   </sect2>
 
+  <sect2 id='xlayouts'>
+    <title>Display Layouts</title>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/xlayouts"/></para>
+
+    <para>Within the <application>X Window System</application> configuration 
+    file there may be multiple layout sections like:</para>
+
+<screen><literal>Section "ServerLayout"
+    Identifier     "X.org Configured"
+    Screen      0  "Screen0" 0 0
+    InputDevice    "Mouse0" "CorePointer"
+    InputDevice    "Keyboard0" "CoreKeyboard"
+EndSection</literal></screen>
+          
+    <para>The default layout is the first, but if you have special needs,
+    you can create others with different configurations.  The 
+    <option>Identifier</option> line in each section is the key.  Different
+    layouts can be created using different Screen and InputDevice 
sections.</para>
+
+    <para>After the configuration file is updated, an alternate configuration
+    can be specified on the <command>startx</command> line.  For instance,
+    to start <application>X</application> with an alternate layout with an
+    Identifier of "layout2", use the following command line:</para>
+
+<screen><command>startx -- -layout layout2</command></screen>
+
+
+  </sect2>
+
 </sect1>

-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to