One that got away
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@874 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Julian Smart
221
src/motif/mdi/README
Normal file
221
src/motif/mdi/README
Normal file
@@ -0,0 +1,221 @@
|
|||||||
|
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
|
||||||
|
|
||||||
Reference in New Issue
Block a user