source: x/installing/x7driver-synaptics.xml@ f5237a8

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

  <!ENTITY xorg-synaptics-driver-version "1.8.0">

  <!ENTITY xorg-synaptics-driver-download-http "&xorg-download-http;/driver/xf86-input-synaptics-&xorg-synaptics-driver-version;.tar.bz2">
  <!ENTITY xorg-synaptics-driver-download-ftp  "&xorg-download-ftp;/driver/xf86-input-synaptics-&xorg-synaptics-driver-version;.tar.bz2">
  <!ENTITY xorg-synaptics-driver-md5sum        "27a3f2b31606a13dd6b58d419978d64f">
  <!ENTITY xorg-synaptics-driver-size          "440 KB">
  <!ENTITY xorg-synaptics-driver-buildsize     "4.8 MB">
  <!ENTITY xorg-synaptics-driver-time          "less than 0.1 SBU">
]>

<!-- Begin Xorg Synaptics Driver -->
  <sect2 id="xorg-synaptics-driver" xreflabel="Xorg Synaptics Driver-&xorg-synaptics-driver-version;">

    <title>Xorg Synaptics Driver-&xorg-synaptics-driver-version;</title>

    <indexterm zone="xorg-synaptics-driver">
      <primary sortas="a-xorg-synaptics-driver">xorg-synaptics-driver</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Xorg Synaptics Driver</title>

      <para>
        The <application>Xorg Synaptics Driver</application> package contains
        the X.Org Input Driver, support programs and SDK for Synaptics
        touchpads. Even though the evdev driver can handle touchpads very well,
        this driver is required if you want to use advanced features like multi
        tapping, scrolling with touchpad, turning the touchpad off while
        typing, etc.
      </para>

      &lfs76_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&xorg-synaptics-driver-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&xorg-synaptics-driver-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &xorg-synaptics-driver-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &xorg-synaptics-driver-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &xorg-synaptics-driver-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &xorg-synaptics-driver-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Xorg Synaptics Driver Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="libevdev"/> and
        <xref linkend="xorg-server"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/xorg-synaptics-driver"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Xorg Synaptics Driver</title>

      <para>
        Install <application>Xorg Synaptics Driver</application> by running the following
        commands:
      </para>

<screen><userinput>sed -i '/_H_/ a#include &lt;xorg-server.h&gt;' src/{eventcomm,ps2comm,synproto}.h &amp;&amp;
./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>

      <para>
        This package does not come with a test suite.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3>
      <title>Command Explanations</title>
      <para>
        <command>sed -i ...</command>: This sed fixes building with the latest
        version of <application>Glibc</application>.
      </para>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Xorg Driver</segtitle>

        <seglistitem>
          <seg>
            synclient and syndaemon
          </seg>
          <seg>
            synaptics_drv.so
          </seg>
        </seglistitem>
      </segmentedlist>

      <variablelist>
        <bridgehead renderas="sect4">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="synclient">
          <term><command>synclient</command></term>
          <listitem>
            <para>
              is a command line utility used to query and modify Synaptics
              driver options.
            </para>
            <indexterm zone="xorg-synaptics-driver synclient">
              <primary sortas="b-synclient">synclient</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="syndaemon">
          <term><command>syndaemon</command></term>
          <listitem>
            <para>
              is a program that monitors keyboard activity and disables the
              touchpad when the keyboard is being used.
            </para>
            <indexterm zone="xorg-synaptics-driver syndaemon">
              <primary sortas="b-syndaemon">syndaemon</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="synaptics_drv">
          <term><filename class="libraryfile">synaptics_drv.so</filename></term>
          <listitem>
            <para>
              is an Xorg input driver for touchpads.
            </para>
            <indexterm zone="xorg-synaptics-driver synaptics_drv">
              <primary sortas="c-synaptics_drv">synaptics_drv.so</primary>
            </indexterm>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect3>

  </sect2>
  <!-- End Xorg Synaptics Driver -->