source: x/installing/x-config.xml@ 25d73a9

<?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">
<sect1info>
<othername>$LastChangedBy: $</othername>
<date>$Date: $</date>
</sect1info>
<?dbhtml filename="xconfig.html"?>
<title>Additional X Windows Configuration</title>

<para>Below you will find information on fine tuning the components of both 
variants of X Windows.  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 convieneint 
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
furthur 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 
inexpensive 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>

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

<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 <parameter>ZAxisMapping</parameter> option, and set the 
<parameter>Buttons</parameter> 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>