source: x/installing/x7lib.xml@ 734823ff

<?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 x7libs-download-http "http://xorg.freedesktop.org/releases/individual/lib/">
  <!ENTITY x7libs-download-ftp  "ftp://ftp.x.org/pub/individual/lib/">
  <!ENTITY x7libs-wget          "&files-anduin;/xorg/lib-&xorg7-release;.wget">
  <!ENTITY x7libs-md5sum        "&files-anduin;/xorg/lib-&xorg7-release;.md5">
  <!ENTITY x7libs-size          "10.7 MB">
  <!ENTITY x7libs-buildsize     "336 MB">
  <!ENTITY x7libs-time          "4.2 SBU">

]>

<sect1 id="xorg7-lib" xreflabel="Xorg Libraries">
  <?dbhtml filename="x7lib.html"?>

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

  <title>Xorg Libraries</title>

  <indexterm zone="xorg7-lib">
    <primary sortas="a-xorg7-lib">Xorg Libraries</primary>
  </indexterm>

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

    <para>The <application>Xorg</application> libraries provide library
    routines that are used within all X Window applications.</para>

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

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Required download list: <ulink url="&x7libs-wget;"/></para>
      </listitem>

    </itemizedlist>

    <bridgehead renderas="sect3">Xorg Libraries Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="ed"/>,
    <xref linkend="fontconfig"/>,
    <xref linkend="xorg7-proto"/>, and
    <xref linkend="libXdmcp"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="libxcb"/> (a modern Xlib replacement)
    and <xref linkend="xmlto"/> with one or more of the following:
    <xref linkend="fop"/>, <xref linkend="Links"/>, <xref linkend="lynx"/>,
    and <xref linkend="w3m"/> (to generate additional PDF or text
    documentation for the libXfont package).</para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url='&blfs-wiki;/Xorg7Libraries'/></para>

  </sect2>

  <sect2>
    <title>Downloading Xorg Libraries</title>

    <para>To download the needed files using <application>wget</application>,
    use the following commands:</para>

<screen><userinput>mkdir lib &amp;&amp;
cd lib &amp;&amp;
grep -v '^#' ../lib-&xorg7-release;.wget | wget -i- -c \
    -B http://xorg.freedesktop.org/releases/individual/lib/ &amp;&amp;
md5sum -c ../lib-&xorg7-release;.md5</userinput></screen>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Xorg Libraries</title>

    <para>Install the libraries by running the following commands for each
    package:</para>

<screen><userinput>case $(basename "$PWD") in
libXfont-[0-9]* )
                 ./configure $XORG_CONFIG --disable-devel-docs
                 ;;
  libX11-[0-9]* )
                 ./configure $XORG_CONFIG --without-xcb
                 ;;
              * )
                 ./configure $XORG_CONFIG
                 ;;
esac &amp;&amp;
make</userinput></screen>

    <para>These packages do not provide test suites.</para>

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

<screen role="root"><userinput>make install &amp;&amp;
ldconfig</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><parameter>--without-xcb</parameter>: By default,
    <application>libX11</application> will use <xref linkend="libxcb"/>
    for its transport layer. Omit this parameter (or the <command>case</command>
    statement) if you've installed <xref linkend="libxcb"/>.</para>

    <para><parameter>--with-fop</parameter>: Use <xref linkend="fop"/> to
    generate PDF documentation (only for the libXfont package).</para>

    <para><parameter>--disable-devel-docs</parameter>: Diable generation of
    text documentation in the libXfont package if
    <xref linkend="xmlto"/> is installed without a text browser. Omit
    this parameter (or the entire <command>case</command> statement) if a text
    browser is installed.</para>
  </sect2>

  <sect2 role="configuration">
    <title>Configuration of Xorg Libraries</title>

    <para>If you've chosen to install <application>Xorg</application> into
    <filename class="directory">/usr</filename>, then no further
    configuration is necessary and you can skip the rest of this section.
    If you've opted for an alternate prefix, you should create two symlinks
    to satisfy the expected environment of several packages.
    Execute the following commands as the root user:</para>

<screen role="root"><userinput>ln -sv $XORG_PREFIX/lib/X11 /usr/lib/X11 &amp;&amp;
ln -sv $XORG_PREFIX/include/X11 /usr/include/X11</userinput></screen>

  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>cxpm, makestrs, sxpm, xft-config</seg>
        <seg>libAppleWM.{so,a}, libdmx.{so,a}, libfontenc.{so,a},
        libFS.{so,a}, libICE.{so,a}, libpciaccess.{so,a}, libSM.{so,a},
        libWindowsWM.{so,a}, libX11.{so,a}, libXaw6.{so,a}, libXaw7.{so,a},
        libXaw.{so,a}, libXcomposite.{so,a}, libXcursor.{so,a},
        libXdamage.{so,a}, libXext.{so,a}, libXfixes.{so,a},
        libXfontcache.{so,a}, libXfont.{so,a}, libXft.{so,a},
        libXinerama.{so,a}, libXi.{so,a}, libxkbfile.{so,a}, libXmu.{so,a},
        libXmuu.{so,a}, libXpm.{so,a}, libXrandr.{so,a}, libXrender.{so,a},
        libXRes.{so,a}, libXss.{so,a}, libXt.{so,a}, libXtst.{so,a},
        libXvMC.{so,a}, libXvMCW.{so,a}, libXv.{so,a}, libXxf86dga.{so,a},
        libXxf86misc.{so,a}, and libXxf86vm.{so,a}</seg>
        <seg>None</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="cxpm-x7">
        <term><command>cxpm</command></term>
        <listitem>
          <para>checks the format of an XPM file.</para>
          <indexterm zone="xorg7-lib cxpm-x7">
            <primary sortas="b-cxpm">cxpm</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="makestrs-x7">
        <term><command>makestrs</command></term>
        <listitem>
          <para>makes string table C source and header(s).</para>
          <indexterm zone="xorg7-lib makestrs-x7">
            <primary sortas="b-makestrs">makestrs</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="sxpm-x7">
        <term><command>sxpm</command></term>
        <listitem>
          <para>shows an XPM file and/or converts XPM 1 or 2 files to
          XPM 3.</para>
          <indexterm zone="xorg7-lib sxpm-x7">
            <primary sortas="b-sxpm">sxpm</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xft-config-x7">
        <term><command>xft-config</command></term>
        <listitem>
          <para>reports Xft version, compiler, linker, and/or installation
          directory information.</para>
          <indexterm zone="xorg7-lib xft-config-x7">
            <primary sortas="b-xft-config">xft-config</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libAppleWM-x7">
        <term><filename class='libraryfile'>libAppleWM.{so,a}</filename></term>
        <listitem>
          <para>is the Apple rootless window management extension.</para>
          <indexterm zone="xorg7-lib libAppleWM-x7">
            <primary sortas="c-libAppleWM">libAppleWM.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libdmx-x7">
        <term><filename class='libraryfile'>libdmx.{so,a}</filename></term>
        <listitem>
          <para>is the X Window System DMX (Distributed Multihead X) extension
          library.</para>
          <indexterm zone="xorg7-lib libdmx-x7">
            <primary sortas="c-libdmx">libdmx.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libfontenc-x7">
        <term><filename class='libraryfile'>libfontenc.{so,a}</filename></term>
        <listitem>
          <para>is the X11 font encoding library.</para>
          <indexterm zone="xorg7-lib libfontenc-x7">
            <primary sortas="c-libfontenc">libfontenc.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libFS-x7">
        <term><filename class='libraryfile'>libFS.{so,a}</filename></term>
        <listitem>
          <para>is the library interface to the X Font Server.</para>
          <indexterm zone="xorg7-lib libFS-x7">
            <primary sortas="c-libFS">libFS.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libICE-x7">
        <term><filename class='libraryfile'>libICE.{so,a}</filename></term>
        <listitem>
          <para>is the X Inter Client Exchange Library.</para>
          <indexterm zone="xorg7-lib libICE-x7">
            <primary sortas="c-libICE">libICE.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libpciaccess-x7">
        <term><filename class='libraryfile'>libpciaccess.{so,a}</filename></term>
        <listitem>
          <para>is the generic PCI Access library for X.</para>
          <indexterm zone="xorg7-lib libpciaccess-x7">
            <primary sortas="c-libpciaccess">libpciaccess.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libSM-x7">
        <term><filename class='libraryfile'>libSM.{so,a}</filename></term>
        <listitem>
          <para>is the X Session Management Library.</para>
          <indexterm zone="xorg7-lib libSM-x7">
            <primary sortas="c-libSM">libSM.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libWindowsWM-x7">
        <term><filename class='libraryfile'>libWindowsWM.{so,a}</filename></term>
        <listitem>
          <para>is the WindowsWM Library based on AppleWM.</para>
          <indexterm zone="xorg7-lib libWindowsWM-x7">
            <primary sortas="c-libWindowsWM">libWindowsWM.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libX11-x7">
        <term><filename class='libraryfile'>libX11.{so,a}</filename></term>
        <listitem>
          <para>is the Xlib Library.</para>
          <indexterm zone="xorg7-lib libX11-x7">
            <primary sortas="c-libX11">libX11.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXaw6-x7">
        <term><filename class='libraryfile'>libXaw6.{so,a}</filename></term>
        <listitem>
          <para>is the X Athena Widgets Library, version 6.</para>
          <indexterm zone="xorg7-lib libXaw6-x7">
            <primary sortas="c-libXaw6">libXaw6.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXaw7-x7">
        <term><filename class='libraryfile'>libXaw7.{so,a}</filename></term>
        <listitem>
          <para>is the X Athena Widgets Library, version 7.</para>
          <indexterm zone="xorg7-lib libXaw7-x7">
            <primary sortas="c-libXaw7">libXaw7.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXaw-x7">
        <term><filename class='libraryfile'>libXaw.{so,a}</filename></term>
        <listitem>
          <para>are symbolic links to the current X Athena Widgets Library,
          version 7.</para>
          <indexterm zone="xorg7-lib libXaw-x7">
            <primary sortas="c-libXaw">libXaw.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXcomposite-x7">
        <term><filename class='libraryfile'>libXcomposite.{so,a}</filename></term>
        <listitem>
          <para>is the X Composite Library.</para>
          <indexterm zone="xorg7-lib libXcomposite-x7">
            <primary sortas="c-libXcomposite">libXcomposite.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXcursor-x7">
        <term><filename class='libraryfile'>libXcursor.{so,a}</filename></term>
        <listitem>
          <para>is the X Cursor management library.</para>
          <indexterm zone="xorg7-lib libXcursor-x7">
            <primary sortas="c-libXcursor">libXcursor.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXdamage-x7">
        <term><filename class='libraryfile'>libXdamage.{so,a}</filename></term>
        <listitem>
          <para>is the X Damage Library.</para>
          <indexterm zone="xorg7-lib libXdamage-x7">
            <primary sortas="c-libXdamage">libXdamage.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXext-x7">
        <term><filename class='libraryfile'>libXext.{so,a}</filename></term>
        <listitem>
          <para>is the Misc X Extension Library.</para>
          <indexterm zone="xorg7-lib libXext-x7">
            <primary sortas="c-libXext">libXext.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXfixes-x7">
        <term><filename class='libraryfile'>libXfixes.{so,a}</filename></term>
        <listitem>
          <para>provides augmented versions of core protocol
          requests.</para>
          <indexterm zone="xorg7-lib libXfixes-x7">
            <primary sortas="c-libXfixes">libXfixes.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXfontcache-x7">
        <term><filename class='libraryfile'>libXfontcache.{so,a}</filename></term>
        <listitem>
          <para>is the X-TrueType font cache extension client library.</para>
          <indexterm zone="xorg7-lib libXfontcache-x7">
            <primary sortas="c-libXfontcache">libXfontcache.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXfont-x7">
        <term><filename class='libraryfile'>libXfont.{so,a}</filename></term>
        <listitem>
          <para>is the X font library.</para>
          <indexterm zone="xorg7-lib libXfont-x7">
            <primary sortas="c-libXfont">libXfont.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXft-x7">
        <term><filename class='libraryfile'>libXft.{so,a}</filename></term>
        <listitem>
          <para>is the X FreeType interface library.</para>
          <indexterm zone="xorg7-lib libXft-x7">
            <primary sortas="c-libXft">libXft.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXinerama-x7">
        <term><filename class='libraryfile'>libXinerama.{so,a}</filename></term>
        <listitem>
          <para>is the Xinerama Library.</para>
          <indexterm zone="xorg7-lib libXinerama-x7">
            <primary sortas="c-libXinerama">libXinerama.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXi-x7">
        <term><filename class='libraryfile'>libXi.{so,a}</filename></term>
        <listitem>
          <para>is the X Input Extension Library.</para>
          <indexterm zone="xorg7-lib libXi-x7">
            <primary sortas="c-libXi">libXi.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libxkbfile-x7">
        <term><filename class='libraryfile'>libxkbfile.{so,a}</filename></term>
        <listitem>
          <para>is the xkbfile Library.</para>
          <indexterm zone="xorg7-lib libxkbfile-x7">
            <primary sortas="c-libxkbfile">libxkbfile.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXmu-x7">
        <term><filename class='libraryfile'>libXmu.{so,a}</filename></term>
        <listitem>
          <para>is the X interface library for miscellaneous utilities not
          part of the Xlib standard.</para>
          <indexterm zone="xorg7-lib libXmu-x7">
            <primary sortas="c-libXmu">libXmu.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXmuu-x7">
        <term><filename class='libraryfile'>libXmuu.{so,a}</filename></term>
        <listitem>
          <para>is the Mini Xmu Library.</para>
          <indexterm zone="xorg7-lib libXmuu-x7">
            <primary sortas="c-libXmuu">libXmuu.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXpm-x7">
        <term><filename class='libraryfile'>libXpm.{so,a}</filename></term>
        <listitem>
          <para>is the X Pixmap Library.</para>
          <indexterm zone="xorg7-lib libXpm-x7">
            <primary sortas="c-libXpm">libXpm.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXrandr-x7">
        <term><filename class='libraryfile'>libXrandr.{so,a}</filename></term>
        <listitem>
          <para>is the X Resize, Rotate and Reflection extension library.</para>
          <indexterm zone="xorg7-lib libXrandr-x7">
            <primary sortas="c-libXrandr">libXrandr.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXrender-x7">
        <term><filename class='libraryfile'>libXrender.{so,a}</filename></term>
        <listitem>
          <para>is the X Render Library.</para>
          <indexterm zone="xorg7-lib libXrender-x7">
            <primary sortas="c-libXrender">libXrender.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXRes-x7">
        <term><filename class='libraryfile'>libXRes.{so,a}</filename></term>
        <listitem>
          <para>is the X-Resource extension client library.</para>
          <indexterm zone="xorg7-lib libXRes-x7">
            <primary sortas="c-libXRes">libXRes.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXss-x7">
        <term><filename class='libraryfile'>libXss.{so,a}</filename></term>
        <listitem>
          <para>is the X11 Screen Saver extension client library.</para>
          <indexterm zone="xorg7-lib libXss-x7">
            <primary sortas="c-libXss">libXss.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXt-x7">
        <term><filename class='libraryfile'>libXt.{so,a}</filename></term>
        <listitem>
          <para>is the X Toolkit Library.</para>
          <indexterm zone="xorg7-lib libXt-x7">
            <primary sortas="c-libXt">libXt.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXtst-x7">
        <term><filename class='libraryfile'>libXtst.{so,a}</filename></term>
        <listitem>
          <para>is the Xtst Library.</para>
          <indexterm zone="xorg7-lib libXtst-x7">
            <primary sortas="c-libXtst">libXtst.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXvMC-x7">
        <term><filename class='libraryfile'>libXvMC.{so,a}</filename></term>
        <listitem>
          <para>is the X-Video Motion Compensation Library.</para>
          <indexterm zone="xorg7-lib libXvMC-x7">
            <primary sortas="c-libXvMC">libXvMC.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXvMCW-x7">
        <term><filename class='libraryfile'>libXvMCW.{so,a}</filename></term>
        <listitem>
          <para>is the XvMC Wrapper including the Nonstandard VLD
          extension.</para>
          <indexterm zone="xorg7-lib libXvMCW-x7">
            <primary sortas="c-libXvMCW">libXvMCW.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXv-x7">
        <term><filename class='libraryfile'>libXv.{so,a}</filename></term>
        <listitem>
          <para>is the X Window System video extension library.</para>
          <indexterm zone="xorg7-lib libXv-x7">
            <primary sortas="c-libXv">libXv.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXxf86dga-x7">
        <term><filename class='libraryfile'>libXxf86dga.{so,a}</filename></term>
        <listitem>
          <para>is the client library for the XFree86-DGA extension.</para>
          <indexterm zone="xorg7-lib libXxf86dga-x7">
            <primary sortas="c-libXxf86dga">libXxf86dga.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXxf86misc-x7">
        <term><filename class='libraryfile'>libXxf86misc.{so,a}</filename></term>
        <listitem>
          <para>is the client library for the XFree86-Misc X extension.</para>
          <indexterm zone="xorg7-lib libXxf86misc-x7">
            <primary sortas="c-libXxf86misc">libXxf86misc.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXxf86vm-x7">
        <term><filename class='libraryfile'>libXxf86vm.{so,a}</filename></term>
        <listitem>
          <para>is the client library for the XFree86-VidMode X extension.</para>
          <indexterm zone="xorg7-lib libXxf86vm-x7">
            <primary sortas="c-libXxf86vm">libXxf86vm.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>