source: x/lib/lesstif.xml@ 84da85a

<?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;

    <!-- Inserted as a reminder to do this. The mention of a test suite
         is usually right before the root user installation commands. Please
         delete these 12 (including one blank) lines after you are done.-->

    <!-- Use one of the two mentions below about a test suite,
         delete the line that is not applicable. Of course, if the
         test suite uses syntax other than "make check", revise the
         line to reflect the actual syntax to run the test suite -->

    <!-- <para>This package does not come with a test suite.</para> -->
    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->

  <!ENTITY lesstif-download-http "http://prdownloads.sourceforge.net/lesstif/lesstif-&lesstif-version;.tar.bz2">
  <!ENTITY lesstif-download-ftp  " ">
  <!ENTITY lesstif-md5sum        "3096ca456c0bc299d895974d307c82d8">
  <!ENTITY lesstif-size          "2.4 MB">
  <!ENTITY lesstif-buildsize     "160 MB (includes building and running the test suite)">
  <!ENTITY lesstif-time          "2.89 SBU (includes building the test suite)">
]>

<sect1 id="lesstif" xreflabel="LessTif-&lesstif-version;">
  <?dbhtml filename="lesstif.html" ?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
    <keywordset>
      <keyword role="package">lesstif-&lesstif-version;.tar</keyword>
      <keyword role="ftpdir">lesstif</keyword>
    </keywordset>
  </sect1info>

  <title>LessTif-&lesstif-version;</title>

  <indexterm zone="lesstif">
    <primary sortas="a-LessTif">LessTif</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to LessTif</title>

    <para>The <application>LessTif</application> package contains an Open
    Source version of <application>OSF/Motif®</application>.</para>

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

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing='compact'>
    <listitem>
    <para>Required patch: <ulink
    url="&patch-root;/lesstif-&lesstif-version;-testsuite_fix-1.patch"/></para>
    </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">LessTif Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="x-window-system"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="lynx"/> or <xref linkend="Links"/>
    (used to generate the <filename>INSTALL</filename> documentation file) and
    <ulink url="http://dmalloc.com">Dmalloc</ulink></para>

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

  </sect2>

  <sect2 role="installation">
    <title>Installation of LessTif</title>

    <para>Install <application>LessTif</application> by running the following
    commands:</para>

<screen><userinput>patch -Np1 -i ../lesstif-&lesstif-version;-testsuite_fix-1.patch &amp;&amp;
./configure --prefix=/usr --disable-debug \
    --enable-production --with-xdnd &amp;&amp;
make rootdir=/usr/share/doc/lesstif-&lesstif-version;</userinput></screen>

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

<screen role="root"><userinput>make rootdir=/usr/share/doc/lesstif-&lesstif-version; install &amp;&amp;
mv -v /usr/X11R6/lib/X11/mwm /etc/X11 &amp;&amp;
ln -v -s ../../../../etc/X11/mwm /usr/X11R6/lib/X11 &amp;&amp;
ldconfig</userinput></screen>

  </sect2>

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

<!-- Disabled these parameters as they are the default
<para><parameter>-enable-build-21</parameter>: Build the
<application>Motif</application> 2.1 compatible version of the
<application>LessTif</application> libraries.</para>

<para><parameter>-disable-build-tests</parameter>: Do not build the
<filename class="directory">test/</filename> tree (see Testing
<application>LessTif</application>).</para>
 -->

    <para><parameter>--disable-debug</parameter>: Do not generate debugging
    information.</para>

    <para><parameter>--enable-production</parameter>: Build the release version
    of the <application>LessTif</application> libraries.</para>

    <para><parameter>--with-xdnd</parameter>: Enable XDND GNOME compatibility
    support.</para>

    <para><parameter>rootdir=/usr/share/doc/lesstif-&lesstif-version;</parameter>:
    This installs the documentation into an appropriate directory instead of the
    non-FHS compliant <filename class="directory">/usr/LessTif</filename>
    directory.</para>

    <para><command>mv -v /usr/X11R6/lib/X11/mwm /etc/X11</command>: The
    <filename class="directory">mwm</filename> configuration directory is moved
    to its proper FHS location in
    <filename class="directory">/etc/X11</filename>.</para>

    <para><command>ln -v -s ../../../../etc/X11/mwm /usr/X11R6/lib/X11</command>:
    A symlink required by some legacy applications is created pointing to the
    <filename class="directory">mwm</filename> configuration directory moved in
    the previous command.</para>

  </sect2>

  <sect2 role="testing">
    <title>Testing LessTif</title>

    <para>It is advisable to test the installation of
    <application>LessTif</application> using the included test suite. It is
    not required to install any of the resulting binaries to validate the
    installation. Issue the following commands to build the test suite:</para>

<screen><userinput>cd test &amp;&amp;
./configure &amp;&amp;
make</userinput></screen>

    <para>To run the tests, issue the following commands:</para>

<screen><userinput>cd Xm &amp;&amp;
./testall *</userinput></screen>

    <para>You'll need to manually close three of the test windows. The first
    one is from <command>test28</command> in the
    <filename class='directory'>list</filename> directory. The second one is
    from <command>test10</command> in the
    <filename class='directory'>menushell</filename> directory. You should
    click on the button in the window and choose <quote>exit</quote> (do it
    twice) to finish the test. The third test is from <command>test24</command>
    in the <filename class='directory'>scrolledwindow</filename>
    directory.</para>

    <para>As many as 100 tests are known to fail. The patch applied at the
    beginning of the installation created a file used to compare known failures
    to the failures from the test run. This file was created from an
    installation using the current LFS book and should be a fairly accurate
    representation of the failures you'll encounter. You could see some minor
    variances, however.</para>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring LessTif</title>

    <sect3 id="lesstif-config">
      <title>Config Files</title>

      <para><filename>/etc/X11/mwm/system.mwmrc</filename> and
      <filename>~/.mwmrc</filename></para>

      <indexterm zone="lesstif lesstif-config">
        <primary sortas="e-AA.mwmrc">~/.mwmrc</primary>
      </indexterm>

      <indexterm zone="lesstif lesstif-config">
        <primary
        sortas="e-etc-X11-mwm-system.mwmrc">/etc/X11/mwm/system.mwmrc</primary>
      </indexterm>

    </sect3>

    <sect3>
      <title>Configuration Information</title>

      <para>The config files are used to customize the behavior of the
      <command>mwm</command> window manager. Information about customizing
      these files can be found in the <filename>mwmrc(5)</filename> man
      page.</para>

    </sect3>

  </sect2>

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

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

      <seglistitem>
        <seg>motif-config, mwm, mxmkmf, uil, and xmbind</seg>
        <seg>libDtPrints.so, libMrm.so, libUil.so, and libXm.so</seg>
        <seg>/etc/X11/mwm, /usr/include/Xm, /usr/include/Mrm,
        /usr/include/uil, /usr/include/Dt, /usr/lib/LessTif, and
        /usr/share/doc/lesstif-&lesstif-version;</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="motif-config">
        <term><command>motif-config</command></term>
        <listitem>
          <para>is used to find out configuration information for packages
          needing to link to the <application>LessTif</application>
          libraries.</para>
          <indexterm zone="lesstif motif-config">
            <primary sortas="b-motif-config">motif-config</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mwm">
        <term><command>mwm</command></term>
        <listitem>
          <para>is a window manager that adheres largely to the
          <application>Motif</application> <command>mwm</command>
          specification.</para>
          <indexterm zone="lesstif mwm">
            <primary sortas="b-mwm">mwm</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mxmkmf">
        <term><command>mxmkmf</command></term>
        <listitem>
          <para>is the <application>LessTif</application> version of
          <command>xmkmf</command> which creates a
          <filename>Makefile</filename> from an
          <filename>Imakefile</filename>.</para>
          <indexterm zone="lesstif mxmkmf">
            <primary sortas="b-mxmkmf">mxmkmf</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="uil">
        <term><command>uil</command></term>
        <listitem>
          <para>is a user interface language compiler which translates a
          plain text description of the user interface of a
          <application>Motif</application> application into a
          machine-readable form.</para>
          <indexterm zone="lesstif uil">
            <primary sortas="b-uil">uil</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xmbind">
        <term><command>xmbind</command></term>
        <listitem>
          <para> configures the virtual key bindings of
          <application>LessTif</application> applications.</para>
          <indexterm zone="lesstif xmbind">
            <primary sortas="b-xmbind">xmbind</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libXm">
        <term><filename class='libraryfile'>libXm.so</filename></term>
        <listitem>
          <para>is an <application>OSF/Motif®</application> source code
          compatible library for the <application>X Window
          System</application>. You can download an excellent reference
          guide (mainly for programmers) for the Motif-2.1 specification
          from <ulink
          url="http://unc.dl.sourceforge.net/lesstif/6B_book.pdf"/>.</para>
          <indexterm zone="lesstif libXm">
            <primary sortas="c-libXm">libXm.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>