source: x/installing/x-config.xml@ ad16af6

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="x-config">
  <?dbhtml filename="xconfig.html"?>

  <sect1info>
  <othername>$LastChangedBy$</othername>
  <date>$Date$</date>
  </sect1info>

  <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
  links are specifically for <application>XFree86</application>, however, the
  information contained in those documents usually pertains to
  <application>Xorg</application> as well.</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>

    <sect3 id='xkeyboard'>
      <title>Keyboards</title>

      <para><ulink url="http://www.xfree86.org/current/XKB-Config.html">The
      <application>XKB</application> Configuration Guide</ulink></para>

      <para><ulink url="http://www.xfree86.org/current/XKB-Enhancing.html">How
      to further enhance <application>XKB</application>
      configuration</ulink></para>

    </sect3>

    <sect3 id='xmice'>
      <title>Mice</title>

      <para>Multi-button mice can be used to their full potential by mapping
      the additional buttons to X button events. Wheel mice are a common example.
      The ordinary ones contain two buttons, and a scroll wheel that doubles as
      a third button.  As far as <application>X</application> is concerned, there
      are 5 buttons as it counts the 'scroll up' and 'scroll down' functions
      (internally they are buttons). Here is an example 'InputDevice' section for
      a typical PS/2 wheel mouse:</para>

<screen><literal>Section "InputDevice"
  Identifier  "Mouse 0"
  Driver      "mouse"
  Option      "Device"        "/dev/input/mice"
  Option      "Protocol"      "IMPS/2"
  Option      "ZAxisMapping"  "4 5"
  Option      "Buttons"       "5"
EndSection</literal></screen>

      <para>Button assignments differ for every mouse type. On more exotic
      mice, you may find that the rocker wheel buttons are 6 and 7. Simply
      add those values to the <option>ZAxisMapping</option> option, and set
      the <option>Buttons</option> option appropriately to enable side to
      side scrolling. Additional information on button assignment can be
      found in the following <application>XFree86</application>
      document:</para>

      <para><ulink url="http://www.xfree86.org/current/mouse.html">Mouse
      Support in <application>XFree86</application></ulink></para>

    </sect3>

    <sect3 id='xinput-other'>
      <title>Other</title>

      <para>To be added...</para>

    </sect3>

  </sect2>

  <sect2>
    <title>Fine Tuning Display Settings</title>

    <sect3>
      <title>The 'Monitor' Section</title>

      <para>To be added...</para>

    </sect3>

    <sect3>
      <title>The 'Device' Section</title>

      <para>To be added...</para>

      <para><ulink
      url="http://www.xfree86.org/current/manindex4.html">Devices</ulink></para>

    </sect3>

  </sect2>

</sect1>