glfs/x/installing/x7app.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 x7apps-download-http "http://xorg.freedesktop.org/releases/individual/app/">
  <!ENTITY x7apps-download-ftp  "ftp://ftp.x.org/pub/individual/app/">
  <!ENTITY x7apps-wget          "&files-anduin;/xorg/app-&xorg7-release;.wget">
  <!ENTITY x7apps-md5sum        "&files-anduin;/xorg/app-&xorg7-release;.md5">
  <!ENTITY x7apps-size          "5.3 MB">
  <!ENTITY x7apps-buildsize     "60 MB">
  <!ENTITY x7apps-time          "1.2 SBU">

]>

<sect1 id="xorg7-app" xreflabel="Xorg Applications">
  <?dbhtml filename="x7app.html"?>

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

  <title>Xorg Applications</title>

  <indexterm zone="xorg7-app">
    <primary sortas="a-xorg7-app">Xorg-&xorg7-version; Applications</primary>
  </indexterm>

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

    <para>The <application>Xorg</application> applications provide the
    expected applications available in previous X Window
    implementations.</para>

    &lfs71_checked;

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

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

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="libpng"/>,
    <xref linkend="mesalib"/> (required for OpenGL support),
    <xref linkend="xcb-util"/>, and
    <xref linkend="xorg7-lib"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="linux-pam"/></para>

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

  </sect2>

  <sect2>
    <title>Downloading Xorg Applications</title>

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

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

  </sect2>

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

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

<screen><userinput>case $(basename "$PWD") in
   twm-[0-9]* )
      sed -i -e '/^rcdir =/s,^\(rcdir = \).*,\1/etc/X11/app-defaults,' \
                src/Makefile.in &amp;&amp;
      ./configure $XORG_CONFIG
      ;;

   xinit-[0-9]* )
      ./configure $XORG_CONFIG --with-xinitdir=/etc/X11/app-defaults
      ;;
     
   * )
      ./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</userinput></screen>

  </sect2>


  <sect2 role="commands">
    <title>Command Explanations</title>
    <para><command>sed -i -e '/^rcdir =/s...</command>: This command ensures
    the <application>twm</application> configuration file gets installed in 
    the proper location.</para>
  </sect2>


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

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

      <seglistitem>
        
        <seg>bdftopcf, iceauth, luit, mkfontdir,mkfontscale, sessreg,
        setxkbmap, smproxy, startx, twm, x11perf, x11perfcomp, xauth, xclock,
        xcmsdb, xcursorgen, xdpr, xdpyinfo, xdriinfo, xev, xgamma, xhost,
        xinit, xkbbell, xkbcomp, xkbevd, xkbvleds, xkbwatch, xkill, xlsatoms,
        xlsclients, xmodmap, xpr, xprop, xrandr, xrdb, xrefresh, xset,
        xsetroot, xvinfo, xwd, xwininfo, and xwud</seg>
        <seg>None</seg>
        <seg>/etc/X11/app-defaults</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="appres-x7">
        <term><command>appres</command></term>
        <listitem>
          <para>lists the X application resource database.</para>
          <indexterm zone="xorg7-app appres-x7">
            <primary sortas="b-appres">appres</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="bdftopcf-x7">
        <term><command>bdftopcf</command></term>
        <listitem>
          <para>converts an X font from Bitmap Distribution Format to Portable
          Compiled Format.</para>
          <indexterm zone="xorg7-app bdftopcf-x7">
            <primary sortas="b-bdftopcf">bdftopcf</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="iceauth-x7">
        <term><command>iceauth</command></term>
        <listitem>
          <para>is the ICE authority file utility.</para>
          <indexterm zone="xorg7-app iceauth-x7">
            <primary sortas="b-iceauth">iceauth</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="luit-x7">
        <term><command>luit</command></term>
        <listitem>
          <para>provides locale and ISO 2022 support for Unicode
          terminals.</para>
          <indexterm zone="xorg7-app luit-x7">
            <primary sortas="b-luit">luit</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mkfontdir-x7">
        <term><command>mkfontdir</command></term>
        <listitem>
          <para>creates an index of X font files in a directory.</para>
          <indexterm zone="xorg7-app mkfontdir-x7">
            <primary sortas="b-mkfontdir">mkfontdir</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mkfontscale-x7">
        <term><command>mkfontscale</command></term>
        <listitem>
          <para>creates an index of scalable font files for X.</para>
          <indexterm zone="xorg7-app mkfontscale-x7">
            <primary sortas="b-mkfontscale">mkfontscale</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="sessreg-x7">
        <term><command>sessreg</command></term>
        <listitem>
          <para>manages utmp/wtmp entries for non-init clients.</para>
          <indexterm zone="xorg7-app sessreg-x7">
            <primary sortas="b-sessreg">sessreg</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="setxkbmap-x7">
        <term><command>setxkbmap</command></term>
        <listitem>
          <para>sets the keyboard using the X Keyboard Extension.</para>
          <indexterm zone="xorg7-app setxkbmap-x7">
            <primary sortas="b-setxkbmap">setxkbmap</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="smproxy-x7">
        <term><command>smproxy</command></term>
        <listitem>
          <para>is the Session Manager Proxy.</para>
          <indexterm zone="xorg7-app smproxy-x7">
            <primary sortas="b-smproxy">smproxy</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="startx-x7">
        <term><command>startx</command></term>
        <listitem>
          <para>initializes an X session.</para>
          <indexterm zone="xorg7-app startx-x7">
            <primary sortas="b-startx">startx</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="twm-x7">
        <term><command>twm</command></term>
        <listitem>
          <para>is the Tab Window Manager for the X Window System.</para>
          <indexterm zone="xorg7-app twm-x7">
            <primary sortas="b-twm">twm</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="x11perf-x7">
        <term><command>x11perf</command></term>
        <listitem>
          <para>is an X11 server performance test program.</para>
          <indexterm zone="xorg7-app x11perf-x7">
            <primary sortas="b-x11perf">x11perf</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="x11perfcomp-x7">
        <term><command>x11perfcomp</command></term>
        <listitem>
          <para>is an X11 server performance comparison program.</para>
          <indexterm zone="xorg7-app x11perfcomp-x7">
            <primary sortas="b-x11perfcomp">x11perfcomp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xauth-x7">
        <term><command>xauth</command></term>
        <listitem>
          <para>is the X authority file utility.</para>
          <indexterm zone="xorg7-app xauth-x7">
            <primary sortas="b-xauth">xauth</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xclock-x7">
        <term><command>xclock</command></term>
        <listitem>
          <para>is an analog/digital clock for X.</para>
          <indexterm zone="xorg7-app xclock-x7">
            <primary sortas="b-xclock">xclock</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xcmsdb-x7">
        <term><command>xcmsdb</command></term>
        <listitem>
          <para>is the Device Color Characterization utility for the X
          Color Management System.</para>
          <indexterm zone="xorg7-app xcmsdb-x7">
            <primary sortas="b-xcmsdb">xcmsdb</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xcursorgen-x7">
        <term><command>xcursorgen</command></term>
        <listitem>
          <para>creates an X cursor file from a collection of PNG
          images.</para>
          <indexterm zone="xorg7-app xcursorgen-x7">
            <primary sortas="b-xcursorgen">xcursorgen</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xdpr-x7">
        <term><command>xdpr</command></term>
        <listitem>
          <para>dumps an X window directly to a printer.</para>
          <indexterm zone="xorg7-app xdpr-x7">
            <primary sortas="b-xdpr">xdpr</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xdpyinfo-x7">
        <term><command>xdpyinfo</command></term>
        <listitem>
          <para>is a display information utility for X.</para>
          <indexterm zone="xorg7-app xdpyinfo-x7">
            <primary sortas="b-xdpyinfo">xdpyinfo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xdriinfo-x7">
        <term><command>xdriinfo</command></term>
        <listitem>
          <para>queries configuration information of DRI drivers.</para>
          <indexterm zone="xorg7-app xdriinfo-x7">
            <primary sortas="b-xdriinfo">xdriinfo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xev-x7">
        <term><command>xev</command></term>
        <listitem>
          <para>prints contents of X events.</para>
          <indexterm zone="xorg7-app xev-x7">
            <primary sortas="b-xev">xev</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xgamma-x7">
        <term><command>xgamma</command></term>
        <listitem>
          <para>alters a monitor's gamma correction through the X
          server.</para>
          <indexterm zone="xorg7-app xgamma-x7">
            <primary sortas="b-xgamma">xgamma</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xhost-x7">
        <term><command>xhost</command></term>
        <listitem>
          <para>is a server access control program for X.</para>
          <indexterm zone="xorg7-app xhost-x7">
            <primary sortas="b-xhost">xhost</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xinit-x7">
        <term><command>xinit</command></term>
        <listitem>
          <para>is the X Window System initializer.</para>
          <indexterm zone="xorg7-app xinit-x7">
            <primary sortas="b-xinit">xinit</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xkbbell-x7">
        <term><command>xkbbell</command></term>
        <listitem>
          <para>is an XKB utility program that raises a bell event.</para>
          <indexterm zone="xorg7-app xkbbell-x7">
            <primary sortas="b-xkbbell">xkbbell</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xkbcomp-x7">
        <term><command>xkbcomp</command></term>
        <listitem>
          <para>compiles an XKB keyboard description.</para>
          <indexterm zone="xorg7-app xkbcomp-x7">
            <primary sortas="b-xkbcomp">xkbcomp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xkbevd-x7">
        <term><command>xkbevd</command></term>
        <listitem>
          <para>is the XKB event daemon.</para>
          <indexterm zone="xorg7-app xkbevd-x7">
            <primary sortas="b-xkbevd">xkbevd</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xkbvleds-x7">
        <term><command>xkbvleds</command></term>
        <listitem>
          <para>shows the XKB status of keyboard LEDs.</para>
          <indexterm zone="xorg7-app xkbvleds-x7">
            <primary sortas="b-xkbvleds">xkbvleds</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xkbwatch-x7">
        <term><command>xkbwatch</command></term>
        <listitem>
          <para>monitors modifier keys and LEDs.</para>
          <indexterm zone="xorg7-app xkbwatch-x7">
            <primary sortas="b-xkbwatch">xkbwatch</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xkill-x7">
        <term><command>xkill</command></term>
        <listitem>
          <para>kills a client by its X resource.</para>
          <indexterm zone="xorg7-app xkill-x7">
            <primary sortas="b-xkill">xkill</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xlsatoms-x7">
        <term><command>xlsatoms</command></term>
        <listitem>
          <para>lists interned atoms defined on the server.</para>
          <indexterm zone="xorg7-app xlsatoms-x7">
            <primary sortas="b-xlsatoms">xlsatoms</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xlsclients-x7">
        <term><command>xlsclients</command></term>
        <listitem>
          <para>lists client applications running on a display.</para>
          <indexterm zone="xorg7-app xlsclients-x7">
            <primary sortas="b-xlsclients">xlsclients</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xmodmap-x7">
        <term><command>xmodmap</command></term>
        <listitem>
          <para>is a utility for modifying keymaps and pointer button
          mappings in X.</para>
          <indexterm zone="xorg7-app xmodmap-x7">
            <primary sortas="b-xmodmap">xmodmap</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xpr-x7">
        <term><command>xpr</command></term>
        <listitem>
          <para>prints an X window dump.</para>
          <indexterm zone="xorg7-app xpr-x7">
            <primary sortas="b-xpr">xpr</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xprop-x7">
        <term><command>xprop</command></term>
        <listitem>
          <para>is a property displayer for X.</para>
          <indexterm zone="xorg7-app xprop-x7">
            <primary sortas="b-xprop">xprop</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xrandr-x7">
        <term><command>xrandr</command></term>
        <listitem>
          <para>is a primitive command line interface to RandR
          extension.</para>
          <indexterm zone="xorg7-app xrandr-x7">
            <primary sortas="b-xrandr">xrandr</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xrdb-x7">
        <term><command>xrdb</command></term>
        <listitem>
          <para>is the X server resource database utility.</para>
          <indexterm zone="xorg7-app xrdb-x7">
            <primary sortas="b-xrdb">xrdb</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xrefresh-x7">
        <term><command>xrefresh</command></term>
        <listitem>
          <para>refreshes all or part of an X screen.</para>
          <indexterm zone="xorg7-app xrefresh-x7">
            <primary sortas="b-xrefresh">xrefresh</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xset-x7">
        <term><command>xset</command></term>
        <listitem>
          <para>is the user preference utility for X.</para>
          <indexterm zone="xorg7-app xset-x7">
            <primary sortas="b-xset">xset</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xsetroot-x7">
        <term><command>xsetroot</command></term>
        <listitem>
          <para>is the root window parameter setting utility for X.</para>
          <indexterm zone="xorg7-app xsetroot-x7">
            <primary sortas="b-xsetroot">xsetroot</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xvinfo-x7">
        <term><command>xvinfo</command></term>
        <listitem>
          <para>prints out X-Video extension adaptor information.</para>
          <indexterm zone="xorg7-app xvinfo-x7">
            <primary sortas="b-xvinfo">xvinfo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xwd-x7">
        <term><command>xwd</command></term>
        <listitem>
          <para>dumps an image of an X window.</para>
          <indexterm zone="xorg7-app xwd-x7">
            <primary sortas="b-xwd">xwd</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xwininfo-x7">
        <term><command>xwininfo</command></term>
        <listitem>
          <para>is a window information utility for X.</para>
          <indexterm zone="xorg7-app xwininfo-x7">
            <primary sortas="b-xwininfo">xwininfo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xwud-x7">
        <term><command>xwud</command></term>
        <listitem>
          <para>is an image displayer for X.</para>
          <indexterm zone="xorg7-app xwud-x7">
            <primary sortas="b-xwud">xwud</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>