no real changes

[wxWidgets.git] / docs / motif / install.txt

diff --git a/docs/motif/install.txt b/docs/motif/install.txt
index 214fd8ee772110c3a631f80c997fb84f1e7d4907..2eada2b3f4788abc2d978757ac07996c5f6f1832 100644 (file)
--- a/docs/motif/install.txt
+++ b/docs/motif/install.txt
@@ -1,4 +1,4 @@
-wxWindows 2.0 for Motif installation
+wxWindows 2.3 for Motif installation

 ------------------------------------
 
 IMPORTANT NOTE:
 ------------------------------------
 
 IMPORTANT NOTE:


@@ -11,7 +11,7 @@ IMPORTANT NOTE:
   
   When sending bug reports tell us what version of wxWindows you are 
   using (including the beta) and what compiler on what system. One 
   
   When sending bug reports tell us what version of wxWindows you are 
   using (including the beta) and what compiler on what system. One 

-  example: wxMotif 2.1 beta 6, egcs 1.1.1, Redhat 5.0
+  example: wxMotif 2.3.0, egcs 1.1.1, Redhat 5.0

 
 First steps
 -----------
 
 First steps
 -----------


@@ -19,17 +19,12 @@ First steps
 - Prerequisites: Motif 1.2 or above, or Lesstif
   (not yet tested). Motif 2.0 and above may also be suitable.
 
 - Prerequisites: Motif 1.2 or above, or Lesstif
   (not yet tested). Motif 2.0 and above may also be suitable.
 

-- Download the appropriate .tgz archive, or alternatively the files
-  wx200gen.zip and wx200mot.zip. Download documentation in a preferred format,
-  such as wx200htm.zip or wx200pdf.zip.
+- Download wxMotif-x.y.z.tgz, where x.y.z is the version number.
+  Download documentation in a preferred format, such as
+  wxWindows-HTML.zip or wxWindows-PDF.zip.

 
 - Make a directory such as ~/wx and unarchive the files into this
 
 - Make a directory such as ~/wx and unarchive the files into this

-  directory. If using the zip archives, use the -a option if available
-  to convert the ASCII files to Unix format. Don't worry about files being
-  overwritten: they should be identical anyway.
-
-  (See http://www.cdrom.com/pub/infozip/ if you don't have zip/unzip
-  already installed. Zip isn't the same as gzip!)
+  directory.

 
 - It is recommended that you install bison and flex; using yacc
   and lex may require tweaking of the makefiles. You also need
 
 - It is recommended that you install bison and flex; using yacc
   and lex may require tweaking of the makefiles. You also need


@@ -177,8 +172,51 @@ make install
 ldconfig
 exit
   
 ldconfig
 exit
   

-NB: DO NOT COMPILE WXGTK WITH GCC AND THREADS, SINCE ALL PROGRAMS WILL CRASH UPON 
-START-UP! Just always use egcs and be happy.
+NB: DO NOT COMPILE WXGTK WITH GCC AND THREADS, SINCE ALL PROGRAMS WILL
+CRASH UPON START-UP! Just always use egcs and be happy.
+
+* Building wxGTK on OS/2
+--------------------------
+
+Please send comments and question about the OS/2 installation
+to Andrea Venturoli <a.ventu@flashnet.it> and patches to
+the wxWindows mailing list.
+
+You'll need OS/2 Warp (4.00FP#6), X-Free86/2 (3.3.3 or newer), 
+Lesstif (0.89.1 or newer), emx (0.9d fix 1), flex (2.5.4),
+yacc (1.8), unix like shell, e.g. korn shell (5.2.13),
+Autoconf (2.13),  GNU file utilities (3.6),
+GNU text utilities (1.3), GNU shell utilites (1.12), m4 (1.4), 
+sed (2.05), grep (2.0), Awk (3.0.3), GNU Make (3.76.1).
+
+Open an OS/2 prompt and switch to the directory above.
+First set some global environment variables we need:
+
+SET CXXFLAGS=-Zmtd -D__ST_MT_ERRNO__
+SET CFLAGS=-Zmtd -D__ST_MT_ERRNO__
+SET OSTYPE=OS2X              
+SET COMSPEC=sh
+
+Notice you can choose whatever you want, if you don't like OS2X.
+
+Now, run autoconf in the main directory and in the samples, demos
+and utils subdirectory. This will generate the OS/2 specific
+versions of the configure scripts. Now run
+    configure --with-motif
+as described above.
+
+To verify Lesstif installation, configure will try to compile a
+sample program that requires X headers/libraries to be either
+available via C_INCLUDE_PATH and LIBRARY_PATH or you need to
+explicitly set CFLAGS prior to running configure.
+
+If you have pthreads library installed, it will be autodetected
+and the library will be compiled with thread-support.
+
+Note that configure assumes your flex will generate files named
+"lexyy.c", not "lex.yy.c". If you have a version which does
+generate "lex.yy.c", you need to manually change the generated
+makefile.

 
 * Building wxMotif on SGI
 --------------------------
 
 * Building wxMotif on SGI
 --------------------------


@@ -203,12 +241,12 @@ The SGI native compiler support has only been tested on Irix 6.5.
 
 Usage:
        ./configure options
 
 Usage:
        ./configure options

-`
+

 If you want to use system's C and C++ compiler,
 If you want to use system's C and C++ compiler,

-set environment variables CC and CCC as
+set environment variables CXX and CC as

 
        % setenv CC cc
 
        % setenv CC cc

-       % setenv CCC CC
+       % setenv CXX CC

        % ./configure options
 
 to see all the options please use:
        % ./configure options
 
 to see all the options please use:


@@ -394,13 +432,13 @@ g++ myfoo.cpp `wx-config --libs` `wx-config --cflags` -o myfoo
 Using this way, a make file for the minimal sample would look
 like this
 
 Using this way, a make file for the minimal sample would look
 like this
 

-CC = g++
+CXX = g++

 
 minimal: minimal.o
 
 minimal: minimal.o

-    $(CC) -o minimal minimal.o `wx-config --libs` 
+    $(CXX) -o minimal minimal.o `wx-config --libs` 

 
 minimal.o: minimal.cpp mondrian.xpm
 
 minimal.o: minimal.cpp mondrian.xpm

-    $(CC) `wx-config --cflags` -c minimal.cpp -o minimal.o
+    $(CXX) `wx-config --cflags` -c minimal.cpp -o minimal.o

 
 clean: 
        rm -f *.o minimal
 
 clean: 
        rm -f *.o minimal


@@ -417,8 +455,9 @@ and configure before you can type make.
 * Further notes by Julian Smart
 ---------------------------------
 
 * Further notes by Julian Smart
 ---------------------------------
 

-- You may find the following script useful for compiling wxMotif:
-  Make this script executable with the command
+- You may find the following script useful for compiling wxMotif,
+  especially if installing from zips (which don't preserve file
+  permissions). Make this script executable with the command

   chmod a+x makewxmotif.
 
   -------:x-----Cut here-----:x-----
   chmod a+x makewxmotif.
 
   -------:x-----Cut here-----:x-----


@@ -562,5 +601,5 @@ compiler and the error message(s) to the wxwin-developers mailing list at:
 
     wxwin-developers@wx.dent.med.uni-muenchen.de
 
 
     wxwin-developers@wx.dent.med.uni-muenchen.de
 

-Julian Smart, February 1999.
-julian.smart@ukonline.co.uk
+Julian Smart, Robert Roebling and Vadim Zeitlin, November 1999.
+