Changeset 31eff503


Ignore:
Timestamp:
05/20/2005 05:17:42 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, ken/inkscape-core-mods, krejzi/svn, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226
Children:
75107a42
Parents:
31215c1
Message:

Tagged lesstif.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4379 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • x/lib/lesstif.xml

    r31215c1 r31eff503  
    1414
    1515<sect1 id="lesstif" xreflabel="LessTif-&lesstif-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="lesstif.html" ?>
    21 <title><application>LessTif</application>-&lesstif-version;</title>
    22 <indexterm zone="lesstif">
    23 <primary sortas="a-LessTif">LessTif</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application>LessTif</application></title>
    27 
    28 <para>The <application>LessTif</application> package contains an Open
    29 Source version of <application>OSF/Motif®</application>.</para>
    30 
    31 <sect3><title>Package information</title>
    32 <itemizedlist spacing='compact'>
    33 <listitem><para>Download (HTTP):
    34 <ulink url="&lesstif-download-http;"/></para></listitem>
    35 <listitem><para>Download (FTP):
    36 <ulink url="&lesstif-download-ftp;"/></para></listitem>
    37 <listitem><para>Download MD5 sum: &lesstif-md5sum;</para></listitem>
    38 <listitem><para>Download size: &lesstif-size;</para></listitem>
    39 <listitem><para>Estimated disk space required:
    40 &lesstif-buildsize;</para></listitem>
    41 <listitem><para>Estimated build time:
    42 &lesstif-time;</para></listitem></itemizedlist>
    43 </sect3>
    44 
    45 <sect3><title>Additional downloads</title>
    46 <itemizedlist spacing='compact'>
    47 <listitem><para>Required patch: <ulink
    48 url="&patch-root;/lesstif-&lesstif-version;-testsuite_fix-1.patch"/></para></listitem>
    49 </itemizedlist>
    50 </sect3>
    51 
    52 <sect3><title><application>LessTif</application> dependencies</title>
    53 <sect4><title>Required</title>
    54 <para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
    55 </sect4>
    56 
    57 <sect4><title>Optional</title>
    58 <para><xref linkend="lynx"/> or <xref linkend="Links"/> (used to generate the
    59 <filename>INSTALL</filename> documentation file) and
    60 <ulink url="http://dmalloc.com">Dmalloc</ulink></para>
    61 </sect4>
    62 </sect3>
    63 
    64 </sect2>
    65 
    66 <sect2>
    67 <title>Installation of <application>LessTif</application></title>
    68 
    69 <para>Install <application>LessTif</application> by running the following
    70 commands:</para>
    71 
    72 <screen><userinput><command>patch -Np1 -i ../lesstif-&lesstif-version;-testsuite_fix-1.patch &amp;&amp;
     16  <?dbhtml filename="lesstif.html" ?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>LessTif-&lesstif-version;</title>
     24
     25  <indexterm zone="lesstif">
     26    <primary sortas="a-LessTif">LessTif</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to LessTif</title>
     31
     32    <para>The <application>LessTif</application> package contains an Open
     33    Source version of <application>OSF/Motif®</application>.</para>
     34
     35    <bridgehead renderas="sect3">Package Information</bridgehead>
     36    <itemizedlist spacing="compact">
     37      <listitem>
     38        <para>Download (HTTP): <ulink url="&lesstif-download-http;"/></para>
     39      </listitem>
     40      <listitem>
     41        <para>Download (FTP): <ulink url="&lesstif-download-ftp;"/></para>
     42      </listitem>
     43      <listitem>
     44        <para>Download MD5 sum: &lesstif-md5sum;</para>
     45      </listitem>
     46      <listitem>
     47        <para>Download size: &lesstif-size;</para>
     48      </listitem>
     49      <listitem>
     50        <para>Estimated disk space required: &lesstif-buildsize;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Estimated build time: &lesstif-time;</para>
     54      </listitem>
     55    </itemizedlist>
     56
     57    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     58    <itemizedlist spacing='compact'>
     59    <listitem>
     60    <para>Required patch: <ulink
     61    url="&patch-root;/lesstif-&lesstif-version;-testsuite_fix-1.patch"/></para>
     62    </listitem>
     63    </itemizedlist>
     64
     65    <bridgehead renderas="sect3">LessTif Dependencies</bridgehead>
     66
     67    <bridgehead renderas="sect4">Required</bridgehead>
     68    <para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
     69
     70    <bridgehead renderas="sect4">Optional</bridgehead>
     71    <para><xref linkend="lynx"/> or <xref linkend="Links"/> (used to generate
     72    the <filename>INSTALL</filename> documentation file) and
     73    <ulink url="http://dmalloc.com">Dmalloc</ulink></para>
     74
     75  </sect2>
     76
     77  <sect2 role="installation">
     78    <title>Installation of LessTif</title>
     79
     80    <para>Install <application>LessTif</application> by running the following
     81    commands:</para>
     82
     83<screen><userinput>patch -Np1 -i ../lesstif-&lesstif-version;-testsuite_fix-1.patch &amp;&amp;
    7384./configure --prefix=/usr --disable-debug \
    7485    --enable-production --with-xdnd &amp;&amp;
    75 make rootdir=/usr/share/doc/lesstif-&lesstif-version;</command></userinput></screen>
    76 
    77 <para>Now, as the root user:</para>
    78 
    79 <screen><userinput role='root'><command>make rootdir=/usr/share/doc/lesstif-&lesstif-version; install &amp;&amp;
     86make rootdir=/usr/share/doc/lesstif-&lesstif-version;</userinput></screen>
     87
     88    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     89
     90<screen role="root"><userinput>make rootdir=/usr/share/doc/lesstif-&lesstif-version; install &amp;&amp;
    8091mv -v /usr/X11R6/lib/X11/mwm /etc/X11 &amp;&amp;
    8192ln -v -s ../../../../etc/X11/mwm /usr/X11R6/lib/X11 &amp;&amp;
    82 ldconfig</command></userinput></screen>
    83 
    84 </sect2>
    85 
    86 <sect2>
    87 <title>Command explanations</title>
     93ldconfig</userinput></screen>
     94
     95  </sect2>
     96
     97  <sect2 role="commands">
     98    <title>Command Explanations</title>
    8899
    89100<!-- Disabled these parameters as they are the default
    90 <para><parameter>-enable-build-21</parameter>: Build the 
    91 <application>Motif</application> 2.1 compatible version of the 
     101<para><parameter>-enable-build-21</parameter>: Build the
     102<application>Motif</application> 2.1 compatible version of the
    92103<application>LessTif</application> libraries.</para>
    93104
    … …  
    97108 -->
    98109
    99 <para><parameter>--disable-debug</parameter>: Do not generate debugging
    100 information.</para>
    101 
    102 <para><parameter>--enable-production</parameter>: Build the release version
    103 of the <application>LessTif</application> libraries.</para>
    104 
    105 <para><parameter>--with-xdnd</parameter>: Enable <acronym>XDND</acronym>
    106 <acronym>GNOME</acronym> compatibility support.</para>
    107 
    108 <para><parameter>rootdir=/usr/share/doc/lesstif-&lesstif-version;</parameter>:
    109 This installs the documentation into an appropriate directory instead of the
    110 non-FHS compliant <filename class="directory">/usr/LessTif</filename>
    111 directory.</para>
    112 
    113 <para><command>mv -v /usr/X11R6/lib/X11/mwm /etc/X11</command>: The
    114 <filename class="directory">mwm</filename> configuration directory is moved
    115 to its proper <acronym>FHS</acronym> location in
    116 <filename class="directory">/etc/X11</filename>.</para>
    117 
    118 <para><command>ln -v -s ../../../../etc/X11/mwm /usr/X11R6/lib/X11</command>:
    119 A symlink required by some legacy applications is created pointing to the
    120 <filename class="directory">mwm</filename> configuration directory moved in
    121 the previous command.</para>
    122 
    123 </sect2>
    124 
    125 <sect2>
    126 <title>Testing <application>LessTif</application></title>
    127 
    128 <para>It is advisable to test the installation of
    129 <application>LessTif</application> using the included test suite. It is
    130 not required to install any of the resulting binaries to validate the
    131 installation. Issue the following commands to build the test suite:</para>
    132 
    133 <screen><userinput><command>cd test &amp;&amp;
     110    <para><parameter>--disable-debug</parameter>: Do not generate debugging
     111    information.</para>
     112
     113    <para><parameter>--enable-production</parameter>: Build the release version
     114    of the <application>LessTif</application> libraries.</para>
     115
     116    <para><parameter>--with-xdnd</parameter>: Enable XDND GNOME compatibility
     117    support.</para>
     118
     119    <para><parameter>rootdir=/usr/share/doc/lesstif-&lesstif-version;</parameter>:
     120    This installs the documentation into an appropriate directory instead of the
     121    non-FHS compliant <filename class="directory">/usr/LessTif</filename>
     122    directory.</para>
     123
     124    <para><command>mv -v /usr/X11R6/lib/X11/mwm /etc/X11</command>: The
     125    <filename class="directory">mwm</filename> configuration directory is moved
     126    to its proper FHS location in
     127    <filename class="directory">/etc/X11</filename>.</para>
     128
     129    <para><command>ln -v -s ../../../../etc/X11/mwm /usr/X11R6/lib/X11</command>:
     130    A symlink required by some legacy applications is created pointing to the
     131    <filename class="directory">mwm</filename> configuration directory moved in
     132    the previous command.</para>
     133
     134  </sect2>
     135
     136  <sect2 role="installation">
     137    <title>Testing LessTif</title>
     138
     139    <para>It is advisable to test the installation of
     140    <application>LessTif</application> using the included test suite. It is
     141    not required to install any of the resulting binaries to validate the
     142    installation. Issue the following commands to build the test suite:</para>
     143
     144<screen><userinput>cd test &amp;&amp;
    134145./configure &amp;&amp;
    135 make</command></userinput></screen>
    136 
    137 <para>To run the tests, issue the following commands:</para>
    138 
    139 <screen><userinput><command>cd Xm &amp;&amp;
    140 ./testall *</command></userinput></screen>
    141 
    142 <para>You'll need to manually close three of the test windows. The first one
    143 is from <command>test28</command> in the
    144 <filename class='directory'>list</filename> directory. The second one is from
    145 <command>test10</command> in the
    146 <filename class='directory'>menushell</filename> directory. You should click
    147 on the button in the window and choose <quote>exit</quote> (do it twice) to
    148 finish the test. The third test is from <command>test24</command> in the
    149 <filename class='directory'>scrolledwindow</filename> directory.</para>
    150 
    151 <para>As many as 100 tests are known to fail. The patch applied at the
    152 beginning of the installation created a file used to compare known failures
    153 to the failures from the test run. This file was created from an installation
    154 using the current <acronym>LFS</acronym> book and should be a fairly accurate
    155 representation of the failures you'll encounter. You could see some minor
    156 variances, however.</para>
    157 
    158 </sect2>
    159 
    160 <sect2>
    161 <title>Configuring <application>LessTif</application></title>
    162 
    163 <sect3 id="lesstif-config"><title>Config files</title>
    164 <para><filename>/etc/X11/mwm/system.mwmrc</filename> and
    165 <filename>~/.mwmrc</filename></para>
    166 <indexterm zone="lesstif lesstif-config">
    167 <primary sortas="e-AA.mwmrc">~/.mwmrc</primary></indexterm>
    168 <indexterm zone="lesstif lesstif-config">
    169 <primary sortas="e-etc-X11-mwm-system.mwmrc">/etc/X11/mwm/system.mwmrc</primary>
    170 </indexterm>
    171 </sect3>
    172 
    173 <sect3><title>Configuration information</title>
    174 <para>The config files are used to customize the behavior of the
    175 <command>mwm</command> window manager. Information about customizing these
    176 files can be found in the <filename>mwmrc(5)</filename> man page.</para>
    177 </sect3>
    178 
    179 </sect2>
    180 
    181 <sect2>
    182 <title>Contents</title>
    183 
    184 <segmentedlist>
    185 <segtitle>Installed Programs</segtitle>
    186 <segtitle>Installed Libraries</segtitle>
    187 <segtitle>Installed Directories</segtitle>
    188 
    189 <seglistitem>
    190 <seg>motif-config, mwm, mxmkmf, uil and xmbind</seg>
    191 <seg>libDtPrints.so, libMrm.so, libUil.so and libXm.so</seg>
    192 <seg>/etc/X11/mwm, /usr/include/Xm, /usr/include/Mrm, /usr/include/uil,
    193 /usr/include/Dt, /usr/lib/LessTif and
    194 /usr/share/doc/lesstif-&lesstif-version;</seg>
    195 </seglistitem>
    196 </segmentedlist>
    197 
    198 <variablelist>
    199 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    200 <?dbfo list-presentation="list"?>
    201 
    202 <varlistentry id="motif-config">
    203 <term><command>motif-config</command></term>
    204 <listitem><para>is used to find out configuration information for packages
    205 needing to link to the <application>LessTif</application> libraries.</para>
    206 <indexterm zone="lesstif motif-config">
    207 <primary sortas="b-motif-config">motif-config</primary>
    208 </indexterm></listitem>
    209 </varlistentry>
    210 
    211 <varlistentry id="mwm">
    212 <term><command>mwm</command></term>
    213 <listitem><para>is a window manager that adheres largely to the
    214 <application>Motif</application> <command>mwm</command> specification.</para>
    215 <indexterm zone="lesstif mwm">
    216 <primary sortas="b-mwm">mwm</primary>
    217 </indexterm></listitem>
    218 </varlistentry>
    219 
    220 <varlistentry id="mxmkmf">
    221 <term><command>mxmkmf</command></term>
    222 <listitem><para>is the <application>LessTif</application> version of
    223 <command>xmkmf</command> which creates a
    224 <filename>Makefile</filename> from an <filename>Imakefile</filename>.</para>
    225 <indexterm zone="lesstif mxmkmf">
    226 <primary sortas="b-mxmkmf">mxmkmf</primary>
    227 </indexterm></listitem>
    228 </varlistentry>
    229 
    230 <varlistentry id="uil">
    231 <term><command>uil</command></term>
    232 <listitem><para>is a user interface language compiler which translates a plain
    233 text description of the user interface of a <application>Motif</application>
    234 application into a machine-readable form.</para>
    235 <indexterm zone="lesstif uil">
    236 <primary sortas="b-uil">uil</primary>
    237 </indexterm></listitem>
    238 </varlistentry>
    239 
    240 <varlistentry id="xmbind">
    241 <term><command>xmbind</command></term>
    242 <listitem><para> configures the virtual key bindings of
    243 <application>LessTif</application> applications.</para>
    244 <indexterm zone="lesstif xmbind">
    245 <primary sortas="b-xmbind">xmbind</primary>
    246 </indexterm></listitem>
    247 </varlistentry>
    248 
    249 <varlistentry id="libXm">
    250 <term><filename class='libraryfile'>libXm.so</filename></term>
    251 <listitem><para>is an <application><acronym>OSF</acronym>/Motif®</application>
    252 source code compatible library for the
    253 <application>X</application> Window System. You can download an excellent
    254 reference guide (mainly for programmers) for the Motif-2.1 specification
    255 from <ulink url="http://unc.dl.sourceforge.net/lesstif/6B_book.pdf"/>.</para>
    256 <indexterm zone="lesstif libXm">
    257 <primary sortas="c-libXm">libXm.so</primary>
    258 </indexterm></listitem>
    259 </varlistentry>
    260 </variablelist>
    261 
    262 </sect2>
     146make</userinput></screen>
     147
     148    <para>To run the tests, issue the following commands:</para>
     149
     150<screen><userinput>cd Xm &amp;&amp;
     151./testall *</userinput></screen>
     152
     153    <para>You'll need to manually close three of the test windows. The first
     154    one is from <command>test28</command> in the
     155    <filename class='directory'>list</filename> directory. The second one is
     156    from <command>test10</command> in the
     157    <filename class='directory'>menushell</filename> directory. You should
     158    click on the button in the window and choose <quote>exit</quote> (do it
     159    twice) to finish the test. The third test is from <command>test24</command>
     160    in the <filename class='directory'>scrolledwindow</filename>
     161    directory.</para>
     162
     163    <para>As many as 100 tests are known to fail. The patch applied at the
     164    beginning of the installation created a file used to compare known failures
     165    to the failures from the test run. This file was created from an
     166    installation using the current LFS book and should be a fairly accurate
     167    representation of the failures you'll encounter. You could see some minor
     168    variances, however.</para>
     169
     170  </sect2>
     171
     172  <sect2 role="configuration">
     173    <title>Configuring LessTif</title>
     174
     175    <sect3 id="lesstif-config">
     176      <title>Config Files</title>
     177
     178      <para><filename>/etc/X11/mwm/system.mwmrc</filename> and
     179      <filename>~/.mwmrc</filename></para>
     180
     181      <indexterm zone="lesstif lesstif-config">
     182        <primary sortas="e-AA.mwmrc">~/.mwmrc</primary>
     183      </indexterm>
     184
     185      <indexterm zone="lesstif lesstif-config">
     186        <primary
     187        sortas="e-etc-X11-mwm-system.mwmrc">/etc/X11/mwm/system.mwmrc</primary>
     188      </indexterm>
     189
     190    </sect3>
     191
     192    <sect3>
     193      <title>Configuration Information</title>
     194
     195      <para>The config files are used to customize the behavior of the
     196      <command>mwm</command> window manager. Information about customizing
     197      these files can be found in the <filename>mwmrc(5)</filename> man
     198      page.</para>
     199
     200    </sect3>
     201
     202  </sect2>
     203
     204  <sect2 role="content">
     205    <title>Contents</title>
     206
     207    <segmentedlist>
     208      <segtitle>Installed Programs</segtitle>
     209      <segtitle>Installed Libraries</segtitle>
     210      <segtitle>Installed Directories</segtitle>
     211
     212      <seglistitem>
     213        <seg>motif-config, mwm, mxmkmf, uil, and xmbind</seg>
     214        <seg>libDtPrints.so, libMrm.so, libUil.so, and libXm.so</seg>
     215        <seg>/etc/X11/mwm, /usr/include/Xm, /usr/include/Mrm,
     216        /usr/include/uil, /usr/include/Dt, /usr/lib/LessTif, and
     217        /usr/share/doc/lesstif-&lesstif-version;</seg>
     218      </seglistitem>
     219    </segmentedlist>
     220
     221    <variablelist>
     222      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     223      <?dbfo list-presentation="list"?>
     224      <?dbhtml list-presentation="table"?>
     225
     226      <varlistentry id="motif-config">
     227        <term><command>motif-config</command></term>
     228        <listitem>
     229          <para>is used to find out configuration information for packages
     230          needing to link to the <application>LessTif</application>
     231          libraries.</para>
     232          <indexterm zone="lesstif motif-config">
     233            <primary sortas="b-motif-config">motif-config</primary>
     234          </indexterm>
     235        </listitem>
     236      </varlistentry>
     237
     238      <varlistentry id="mwm">
     239        <term><command>mwm</command></term>
     240        <listitem>
     241          <para>is a window manager that adheres largely to the
     242          <application>Motif</application> <command>mwm</command>
     243          specification.</para>
     244          <indexterm zone="lesstif mwm">
     245            <primary sortas="b-mwm">mwm</primary>
     246          </indexterm>
     247        </listitem>
     248      </varlistentry>
     249
     250      <varlistentry id="mxmkmf">
     251        <term><command>mxmkmf</command></term>
     252        <listitem>
     253          <para>is the <application>LessTif</application> version of
     254          <command>xmkmf</command> which creates a
     255          <filename>Makefile</filename> from an
     256          <filename>Imakefile</filename>.</para>
     257          <indexterm zone="lesstif mxmkmf">
     258            <primary sortas="b-mxmkmf">mxmkmf</primary>
     259          </indexterm>
     260        </listitem>
     261      </varlistentry>
     262
     263      <varlistentry id="uil">
     264        <term><command>uil</command></term>
     265        <listitem>
     266          <para>is a user interface language compiler which translates a
     267          plain text description of the user interface of a
     268          <application>Motif</application> application into a
     269          machine-readable form.</para>
     270          <indexterm zone="lesstif uil">
     271            <primary sortas="b-uil">uil</primary>
     272          </indexterm>
     273        </listitem>
     274      </varlistentry>
     275
     276      <varlistentry id="xmbind">
     277        <term><command>xmbind</command></term>
     278        <listitem>
     279          <para> configures the virtual key bindings of
     280          <application>LessTif</application> applications.</para>
     281          <indexterm zone="lesstif xmbind">
     282            <primary sortas="b-xmbind">xmbind</primary>
     283          </indexterm>
     284        </listitem>
     285      </varlistentry>
     286
     287      <varlistentry id="libXm">
     288        <term><filename class='libraryfile'>libXm.so</filename></term>
     289        <listitem>
     290          <para>is an <application>OSF/Motif®</application> source code
     291          compatible library for the <application>X Window
     292          System</application>. You can download an excellent reference
     293          guide (mainly for programmers) for the Motif-2.1 specification
     294          from <ulink
     295          url="http://unc.dl.sourceforge.net/lesstif/6B_book.pdf"/>.</para>
     296          <indexterm zone="lesstif libXm">
     297            <primary sortas="c-libXm">libXm.so</primary>
     298          </indexterm>
     299        </listitem>
     300      </varlistentry>
     301
     302    </variablelist>
     303
     304  </sect2>
    263305
    264306</sect1>
Note: See TracChangeset for help on using the changeset viewer.