Changeset 99fb6aa for x

Timestamp:

04/23/2006 12:11:29 AM (18 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

dad0149a

Parents:

dff0c07f

Message:

Updated Additional X Window System Configuration section

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5914 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• x/installing/x-config.xml (modified) (4 diffs)

x/installing/x-config.xml

@@ -17 +17 @@
 
   <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>
-
-  <para condition="html" role="usernotes">User Notes:
-  <ulink url="&blfs-wiki;/InputMethods"/></para>
+  <application>Xorg</application> as well.  Detailed descripttions are also
+  located in the <filename>xorg.conf</filename> or
+  <filename>XF86Config</filename> man pages.</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
@@ -77 +78 @@
     </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>
 
@@ -99 +138 @@
       <title>The 'Device' Section</title>
 
-      <para>To be added...</para>
-
-      <para><ulink
-      url="http://www.xfree86.org/current/manindex4.html">Devices</ulink></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>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>
@@ -108 +167 @@
   </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>