source: archive/lesstif.xml

trunk
Last change on this file was e294c0f, checked in by Bruce Dubbs <bdubbs@…>, 3 months ago

Get rid of a non-ascii character in an archived file because
git complains under some circumstances.

  • Property mode set to 100644
File size: 11.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY lesstif-download-http "&sourceforge-repo;/lesstif/lesstif-&lesstif-version;.tar.bz2">
8 <!ENTITY lesstif-download-ftp " ">
9 <!ENTITY lesstif-md5sum "754187dbac09fcf5d18296437e72a32f">
10 <!ENTITY lesstif-size "2.4 MB">
11 <!ENTITY lesstif-buildsize "160 MB (includes building and running the test suite)">
12 <!ENTITY lesstif-time "4.1 SBU (includes building the test suite)">
13]>
14
15<sect1 id="lesstif" xreflabel="LessTif-&lesstif-version;">
16 <?dbhtml filename="lesstif.html" ?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>LessTif-&lesstif-version;</title>
23
24 <indexterm zone="lesstif">
25 <primary sortas="a-LessTif">LessTif</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to LessTif</title>
30
31 <para>The <application>LessTif</application> package contains an Open
32 Source version of <application>OSF/Motif</application>.</para>
33
34 &lfs65_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&lesstif-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&lesstif-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &lesstif-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &lesstif-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &lesstif-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &lesstif-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
59 <itemizedlist spacing='compact'>
60 <listitem>
61 <para>Required patch: <ulink
62 url="&patch-root;/lesstif-&lesstif-version;-testsuite_fix-1.patch"/></para>
63 </listitem>
64 </itemizedlist>
65
66 <bridgehead renderas="sect3">LessTif Dependencies</bridgehead>
67
68 <bridgehead renderas="sect4">Required</bridgehead>
69 <para role="required"><xref linkend="xorg7-lib"/></para>
70
71 <bridgehead renderas="sect4">Optional</bridgehead>
72 <para role="optional"><xref linkend="lynx"/> or <xref linkend="Links"/>
73 (used to generate the <filename>INSTALL</filename> documentation file) and
74 <ulink url="http://dmalloc.com">Dmalloc</ulink></para>
75
76 <para condition="html" role="usernotes">User Notes:
77 <ulink url="&blfs-wiki;/lesstif"/></para>
78
79 </sect2>
80
81 <sect2 role="installation">
82 <title>Installation of LessTif</title>
83
84 <para>First, rename a man page file that conflicts with
85 <application>perl</application>:</para>
86
87 <screen><userinput>pushd doc/lessdox/widgets &amp;&amp;
88sed -i -e 's/\tShell.3/\tshell.3/' Makefile.in &amp;&amp;
89mv Shell.3 shell.3 &amp;&amp;
90popd</userinput></screen>
91
92 <para>Install <application>LessTif</application> by running the following
93 commands:</para>
94
95<screen><userinput>patch -Np1 -i ../lesstif-&lesstif-version;-testsuite_fix-1.patch &amp;&amp;
96./configure --prefix=/usr \
97 --sysconfdir=/etc/X11 \
98 --disable-debug \
99 --enable-production \
100 --with-xdnd \
101 --x-includes=$XORG_PREFIX/include \
102 --x-libraries=$XORG_PREFIX/lib &amp;&amp;
103sed -i "s@libdir)/X11/mwm@sysconfdir)/mwm@" clients/Motif-2.1/mwm/Makefile &amp;&amp;
104make rootdir=/usr/share/doc/lesstif-&lesstif-version;</userinput></screen>
105
106 <para>This package requires that it is installed before the test suite is
107 run. The commands to run the tests are located a bit later in the
108 instructions.</para>
109
110 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
111
112<screen role="root"><userinput>make rootdir=/usr/share/doc/lesstif-&lesstif-version; install &amp;&amp;
113ldconfig</userinput></screen>
114
115 <para>Applicatons that utilize Xorg libraries often, and incorrectly,
116 expect to find configuration files in
117 <filename class="directory">$XORG_PREFIX/lib/X11</filename>. While still
118 the <systemitem class="username">root</systemitem> user, create a
119 compatibility symlink with the following command:</para>
120
121<screen role="root"><userinput>ln -v -sf /etc/X11/mwm $XORG_PREFIX/lib/X11</userinput></screen>
122
123 </sect2>
124
125 <sect2 role="commands">
126 <title>Command Explanations</title>
127
128 <para><parameter>--disable-debug</parameter>: Do not generate debugging
129 information.</para>
130
131 <para><parameter>--enable-production</parameter>: Build the release version
132 of the <application>LessTif</application> libraries.</para>
133
134 <para><parameter>--with-xdnd</parameter>: Enable XDND GNOME compatibility
135 support.</para>
136
137 <para><parameter>rootdir=/usr/share/doc/lesstif-&lesstif-version;</parameter>:
138 This installs the documentation into an appropriate directory instead of the
139 non-FHS compliant <filename class="directory">/usr/LessTif</filename>
140 directory.</para>
141
142 <para><parameter>--x-includes</parameter> and
143 <parameter>--x-libraries</parameter>: tells the build system where to find
144 the Xorg headers and libraries.</para>
145
146 <para><command>sed -i "s@libdir)/X11/mwm@sysconfdir)/mwm@"
147 clients/Motif-2.1/mwm/Makefile</command>: This corrects the installation
148 prefix for the mwm directory for FHS compliance.</para>
149
150 </sect2>
151
152 <sect2 role="testing">
153 <title>Testing LessTif</title>
154
155 <para>It is advisable to test the installation of
156 <application>LessTif</application> using the included test suite. It is
157 not required to install any of the resulting binaries to validate the
158 installation. Issue the following commands to build the test suite:</para>
159
160<screen><userinput>cd test &amp;&amp;
161./configure &amp;&amp;
162make</userinput></screen>
163
164 <para>To run the tests, issue the following commands:</para>
165
166<screen><userinput>cd Xm &amp;&amp;
167./testall *</userinput></screen>
168
169 <para>You may need to manually close four of the test windows. The first
170 one is from <command>test28</command> in the
171 <filename class='directory'>list</filename> directory. The second one is
172 from <command>test10</command> in the
173 <filename class='directory'>menushell</filename> directory. You should
174 click on the button in the window and choose <quote>exit</quote> (do it
175 twice) to finish the test. The third test is from <command>test20</command>
176 in the <filename class='directory'>PushButton</filename> and the last one
177 is from <command>test24</command> in the
178 <filename class='directory'>scrolledwindow</filename> directory.</para>
179
180 <!-- Last test run: 86 failed out of 605. -->
181
182 <para>As many as 101 tests are known to fail. The patch applied at the
183 beginning of the installation created a file used to compare known failures
184 to the failures from the test run. This file was created from an
185 installation using the current LFS book and should be a fairly accurate
186 representation of the failures you'll encounter. You could see some minor
187 variances, however.</para>
188
189 </sect2>
190
191 <sect2 role="configuration">
192 <title>Configuring LessTif</title>
193
194 <sect3 id="lesstif-config">
195 <title>Config Files</title>
196
197 <para><filename>/etc/X11/mwm/system.mwmrc</filename> and
198 <filename>~/.mwmrc</filename></para>
199
200 <indexterm zone="lesstif lesstif-config">
201 <primary sortas="e-AA.mwmrc">~/.mwmrc</primary>
202 </indexterm>
203
204 <indexterm zone="lesstif lesstif-config">
205 <primary
206 sortas="e-etc-X11-mwm-system.mwmrc">/etc/X11/mwm/system.mwmrc</primary>
207 </indexterm>
208
209 </sect3>
210
211 <sect3>
212 <title>Configuration Information</title>
213
214 <para>The config files are used to customize the behavior of the
215 <command>mwm</command> window manager. Information about customizing
216 these files can be found in the <filename>mwmrc(5)</filename> man
217 page.</para>
218
219 </sect3>
220
221 </sect2>
222
223 <sect2 role="content">
224 <title>Contents</title>
225
226 <segmentedlist>
227 <segtitle>Installed Programs</segtitle>
228 <segtitle>Installed Libraries</segtitle>
229 <segtitle>Installed Directories</segtitle>
230
231 <seglistitem>
232 <seg>motif-config, mwm, mxmkmf, uil, and xmbind</seg>
233 <seg>libDtPrints.so, libMrm.so, libUil.so, and libXm.so</seg>
234 <seg>/etc/X11/mwm, /usr/include/Xm, /usr/include/Mrm,
235 /usr/include/uil, /usr/include/Dt, /usr/lib/LessTif, and
236 /usr/share/doc/lesstif-&lesstif-version;</seg>
237 </seglistitem>
238 </segmentedlist>
239
240 <variablelist>
241 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
242 <?dbfo list-presentation="list"?>
243 <?dbhtml list-presentation="table"?>
244
245 <varlistentry id="motif-config">
246 <term><command>motif-config</command></term>
247 <listitem>
248 <para>is used to find out configuration information for packages
249 needing to link to the <application>LessTif</application>
250 libraries.</para>
251 <indexterm zone="lesstif motif-config">
252 <primary sortas="b-motif-config">motif-config</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="mwm">
258 <term><command>mwm</command></term>
259 <listitem>
260 <para>is a window manager that adheres largely to the
261 <application>Motif</application> <command>mwm</command>
262 specification.</para>
263 <indexterm zone="lesstif mwm">
264 <primary sortas="b-mwm">mwm</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="mxmkmf">
270 <term><command>mxmkmf</command></term>
271 <listitem>
272 <para>is the <application>LessTif</application> version of
273 <command>xmkmf</command> which creates a
274 <filename>Makefile</filename> from an
275 <filename>Imakefile</filename>.</para>
276 <indexterm zone="lesstif mxmkmf">
277 <primary sortas="b-mxmkmf">mxmkmf</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="uil">
283 <term><command>uil</command></term>
284 <listitem>
285 <para>is a user interface language compiler which translates a
286 plain text description of the user interface of a
287 <application>Motif</application> application into a
288 machine-readable form.</para>
289 <indexterm zone="lesstif uil">
290 <primary sortas="b-uil">uil</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="xmbind">
296 <term><command>xmbind</command></term>
297 <listitem>
298 <para> configures the virtual key bindings of
299 <application>LessTif</application> applications.</para>
300 <indexterm zone="lesstif xmbind">
301 <primary sortas="b-xmbind">xmbind</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="libXm">
307 <term><filename class='libraryfile'>libXm.so</filename></term>
308 <listitem>
309 <para>is an <application>OSF/Motif</application> source code
310 compatible library for the <application>X Window
311 System</application>. You can download an excellent reference
312 guide (mainly for programmers) for the Motif-2.1 specification
313 from <ulink
314 url="http://unc.dl.sourceforge.net/lesstif/6B_book.pdf"/>.</para>
315 <indexterm zone="lesstif libXm">
316 <primary sortas="c-libXm">libXm.so</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 </variablelist>
322
323 </sect2>
324
325</sect1>
Note: See TracBrowser for help on using the repository browser.