Motif Multi-Document Interface Version 1.0
------------------------------------------
INTRODUCTION
============
The Motif Multi-Document Interface (MDI) is a collection of C++ classes
that emulates the behavior of the Multi-Document Interface in Microsoft
Windows. The MDI framework allows a user to view multiple documents (windows)
constrained to a single parent window.
REQUIREMENTS
============
The following are required to build MDI:
C++ compiler
X11R5/X11R6
Motif1.2
PLATFORMS
=========
The MDI package is known to compile on the following platforms:
SGI IRIX 5.2
SunOS 4.1.3
Sun Solaris 5.4
HP-UX 9.05
AIX 4.1
Alpha/OSF1 v3.2
Linux 1.1.90 (gcc version 2.5.8)
INSTALLATION
============
MDI is written in C++. It does not use any language extensions like
exceptions or templates, so it should compile with most C++ compilers.
To build MDI, you need to set the name of your C++ compiler in the file
"config/MDI.tmpl". An attempt is made to pick a logical default for your
machine, but if it fails, you will need to edit this file.
After setting your compiler, just type:
xmkmf
make Makefiles
make
If successful, the MDI library (libXsw.a) will be created in the "lib"
directory. Additionally, a short test program (MDItest) will be created
in the "test" directory.
If you are not successful, see the "Possible Problems" section below. I
have had no luck with imake as it seems to only work on about 1/2 of the
platforms I have tried. If imake does not work, don't despair. The MDI
library is really simple to build by hand. Just follow the following steps
and it will work just fine. I have given detailed instructions in the
"Possible Problems" section below where I had problems using imake. If
anyone sees a problem with my Imakefile (I assume there are many), please
let me know.
In order to build the MDI package by hand, do the following:
1. "cd" into the "lib" directory (cd lib)
2. Compile all of the source code (CC -g -c *.C). Your compiler
name will vary. Some common compilers are:
CC: SGI, Sun, Solaris, HP-UX
xlC: AIX RS/6000
cxx: Alpha/OSF1
g++: Linux
gcc: Most other platforms
3. Create the library "libXsw.a" (ar rlv libXsw.a *.o)
4. Run "ranlib" (not necessary on all machines)
5. "cd" into the "test" directory (cd ../test)
6. Compile the source code (see step #2 above)
7. Link the test program (CC *.o -o MDItest ../lib/libXsw.a \
-lXm -lXt -lX11). Again, the compiler name will vary
If you still can't get it to work after all of that, email me and I'll give
you a hand.
POSSIBLE PROBLEMS
=================
SunOS 4.1.3
Kept getting this message when trying to make:
make: Fatal error: Don't know how to make target `XsComponent.o'
I ended up building the library and test case with the following:
cd lib
CC -g -c *.C
ar rlv libXsw.a *.o
ranlib libXsw.a
cd ../test
CC -g -c *.C -I../lib
CC -g *.o -o MDItest ../lib/libXsw.a -L/usr/lib -lXm -lXt -lX11
Solaris 5.4
The generated Makefile had some unsupported options being passed to
the linker. I don't know what they were for, so I just removed them.
All worked fine after that.
HP-UX 9.05
I did not have "xmkmf" on this platform. To build the library and test
case, I did the following (paths may vary):
cd lib
CC -g -c *.C -I/usr/include/Motif1.2 -I/usr/include/X11R5
ar rlv libXsw.a *.o
cd ../test
CC -g -c *.C -I../lib -I/usr/include/Motif1.2 -I/usr/include/X11R5
CC -g *.o -o MDItest ../lib/libXsw.a -L/usr/lib/Motif1.2 \
-L/usr/lib/X11R5 -lXm -lXt -lX11
AIX 4.1
Running xmkmf on the top Makefile did not work. Got the following:
"./Imakefile", line 8.1: 1506-215 (E) Too many arguments
specified for macro NamedTargetSubdirs.
In order to build the library, I cd'd into both the "lib" and "test"
directory and did the following there:
xmkmf
make
Alpha/OSF1 v3.2
Kept getting this message when trying to make:
Make: Don't know how to make XsComponent.o. Stop.
I ended up building the library and test case with the following:
cd lib
cxx -g -c *.C
ar rlv libXsw.a *.o
cd ../test
cxx -g -c *.C -I../lib
cxx -g *.o -o MDItest ../lib/libXsw.a -lXm -lXt -lX11
Linux
"make Makefiles" did not work correctly. Just cd'd into both the
"lib" and "test" directories and type:
xmkmf
make
Also, if you don't have the C++ library (libC.a), you will get some
undefined symbols like when linking:
../lib/libXsw.a(XsComponent.o): Undefined symbol _cout
referenced from text segment
../lib/libXsw.a(XsComponent.o): Undefined symbol
ostream::operator<<(char const *) referenced from text segment
To get rid of these errors, you will need to recompile the library
(specifically XsComponent.C) with -DNDEBUG. This will remove the calls
to the <iostream> library and will eliminate the need to link with the
C++ library
DOCUMENTATION
=============
All documentation is written in HTML and can be found in the "doc" directory.
The top-most documentation file is "mdi.html"
AVAILABILITY
===============
The latest version of MDI is available at:
ftp://itimail.iti-oh.com/pub/project/sws/MDI-<version>.tar.gz
ftp://itimail.iti-oh.com/pub/project/sws/MDI-<version>.tar.Z
The MDI WWW page is located at:
http://www.iti-oh.com/~sws/mdi.html
COPYRIGHT
=========
Copyright (c) 1996 Scott W. Sadler
All rights reserved.
See license conditions in the COPYRIGHT file of the MDI distribution
BUG REPORTS
===========
Please report any bugs, suggestions or criticisms directly to me at the
address below. I want to make this as quality a software package as
possible: stable, efficient and portable. It is the feedback from the X
community that makes writing the software worthwhile.
Scott W. Sadler
sws@iti-oh.com
http://www.iti-oh.com/~sws
HISTORY
=======
03-Mar-96 Version 1.0 Released
8aa04e8bf1