glfs/x/installing/x7additionaldrivers.xml

<?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-wacom-driver-download-http 
           "&sourceforge-repo;/linuxwacom/xf86-input-wacom-&xorg-wacom-driver-version;.tar.bz2">
  <!ENTITY xorg-wacom-driver-download-ftp  " ">
  <!ENTITY xorg-wacom-driver-md5sum        "23d19a2b50a86b848df17297c745144f">
  <!ENTITY xorg-wacom-driver-size          "504 KB">
  <!ENTITY xorg-wacom-driver-buildsize     "6.5 MB">
  <!ENTITY xorg-wacom-driver-time          "0.1 SBU">

]>

<sect1 id="x7additionaldrivers" xreflabel="Additional Xorg Drivers">
  <?dbhtml filename="x7additionaldrivers.html"?>

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

  <title>Additional Xorg Drivers</title>

  <indexterm zone="x7additionaldrivers">
    <primary sortas="a-x7additionaldrivers">x7additionaldrivers</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Additional Xorg Drivers</title>

    <para>
      The <application>Additional Xorg Drivers</application> page contains the
      instructions for building Xorg drivers that were not included on the
      Xorg Drivers page.
    </para>

    <itemizedlist spacing="compact">
      <listitem>
        <para>
          <xref linkend="xorg-wacom-driver"/>
        </para>
      </listitem>
    </itemizedlist>

  </sect2>

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

    <title>Xorg Wacom Driver-&xorg-wacom-driver-version;</title>

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

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

      <para>
        The <application>Xorg Wacom Driver</application> package contains the 
        X.Org X11 driver and SDK for Wacom and Wacom-like tablets. It is not
        required to use a Wacom tablet, the
        <application>xf86-input-evdev</application> driver can handle these
        devices without problems.
      </para>

      &lfs70_built;

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

      <bridgehead renderas="sect4">Xorg Wacom Drivers Dependencies</bridgehead>

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

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <xref linkend="doxygen"/>
      </para>

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

    <sect3 role="kernel" id="xorg-wacom-driver-kernel">
      <title>Kernel Configuration</title>

      <para>
        To use a Wacom tablet, enable the following options in your kernel
        configuration and recompile:
      </para>

<screen><literal>Device Drivers  ---&gt;
  Input device support  ---&gt;
    [*]   Tablets  ---&gt;
      [*]   Wacom Intuos/Graphire tablet support (USB)</literal></screen>

      <indexterm zone="xorg-wacom-driver xorg-wacom-driver-kernel">
        <primary sortas="d-xorg-wacom-driver">xorg-wacom-driver</primary>
      </indexterm>
    </sect3>

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

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

<screen><userinput>./configure $XORG_CONFIG \
            --with-xorg-module-dir=$XORG_PREFIX/lib/X11/modules &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 role="commands">
      <title>Command Explanations</title>

      <para>
        <parameter>--with-xorg-module-dir=...</parameter>: This switch
        ensures that the drivers are installed into the correct directory.
      </para>

    </sect3>

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

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Library</segtitle>

        <seglistitem>
          <seg>
            isdv4-serial-debugger and xsetwacom
          </seg>
          <seg>
            wacom_drv.so
          </seg>
        </seglistitem>
      </segmentedlist>

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

        <varlistentry id="xsetwacom">
          <term><command>xsetwacom</command></term>
          <listitem>
            <para>
              is an commandline utility used to query 
              and modify wacom driver settings.
            </para>
            <indexterm zone="xorg-wacom-driver xsetwacom">
              <primary sortas="b-xsetwacom">xsetwacom</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="wacom_drv">
          <term><filename class="libraryfile">wacom_drv.so</filename></term>
          <listitem>
            <para>
              is an X input driver for Wacom devices.
            </para>
            <indexterm zone="xorg-wacom-driver wacom_drv">
              <primary sortas="c-wacom_drv">wacom_drv.so</primary>
            </indexterm>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect3>

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

</sect1>