Cured BC++ makefile bug; wxGrid fix; updated Motif install.txt
[wxWidgets.git] / docs / motif / install.txt
1 wxWindows 2.0 for Motif installation
2 ------------------------------------
3
4 - Prerequisites: Motif 1.2 or above, or
5   Lesstif (not yet tested).
6
7 - Download the files wx200gen.zip and wx200mot.zip, and
8   documentation in a preferred format, such as wx200htm.zip
9   or wx200pdf.zip.
10
11 - Make a directory such as ~/wx and unzip the files into this
12   directory. Use the -a option if available to convert the ASCII
13   files to Unix format. Don't worry about files being
14   overwritten: they should be identical anyway.
15
16 - Edit src/make.env to change options according to your local
17   environment. In particular, change WXDIR to where wxWindows is
18   found on your system.
19   Later, there will be a better makefile system
20   and/or alternate make.env files as per wxWindows 1.68.
21   Please feel free to contribute settings files for your environment.
22
23 - Change directory to src/motif and type:
24
25     make -f makefile.unx motif
26
27   This should make the library libwx_motif.a in the lib
28   directory.
29
30 - Make a sample, such as the minimal sample:
31
32     cd samples/minimal
33     make -f makefile.unx motif
34
35   and run the resulting minimal_motif binary.
36
37 Notes:
38 ------
39
40 - Better installation and makefile systems are
41   required. I didn't use the wxGTK system because I couldn't
42   understand it or make it work with wxMotif. Also I think
43   we should use something that can be made to work easily
44   with applications outside the wxWindows hierarchy.
45
46 - Debugging mode is switched on by default. To compile in non-debug
47   mode, remove the -D__WXDEBUG__ switch in make.env.
48
49 - Some classes can be switched off in include/wx/motif/setup.h,
50   if you are having trouble with a particular file. However,
51   I'd prefer you to fix the problem and send the fix to me :-) or at
52   least let me know about it.
53
54 - If you run into problems with a missing X11/Xpm.h header, you
55   need to install the XPM package. It can be obtained from:
56
57   ftp://ftp.x.org/contrib/libraries/xpm-3.4k.tar.gz
58
59   Alternatively, edit include/motif/setup.h, set wxUSE_XPM
60   to 0, and recompile. You will not be able to load any XPMs,
61   though (currently the only supported colour bitmap format).
62
63 - Please send bug reports with a description of your environment,
64   compiler and the error message(s) to the wxwin-users mailing list at:
65
66     wxwin-users@wx.dent.med.uni-muenchen.de
67
68
69 Julian Smart, November 1998.
70 julian.smart@ukonline.co.uk