Committing in .

Modified Files:
 	wxWindows/docs/readme_vms.txt

 Updated VMS build instructions
----------------------------------------------------------------------


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@8470 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/readme_vms.txt

@@ -6,37 +6,38 @@ The compilation was tested with
     -DECC 6.2
     -Compac C++ 6.2
     -DECWindows 1.2-5
-    -Mozilla M14 (for the GTK-stuff)
+    -GTK1.2.8 (for wxGTK)
     
-To get everything compiled you'll need to have installed:
+To get everything compiled you'll need to have installed prior to compiling
+wxWindows:
     -Bison
+      get it from http://www.openvms.digital.com/freeware/
+      You' have to fix the following bug:
+        add the following 3 lines in BISON.SIMPLE
+	  #elif __VMS
+	  #include <stdlib.h>
+	  #define alloca malloc
+        before
+	  #endif /* __hpux */
+        
     -Flex
+      get it from http://www.openvms.digital.com/freeware/
+
     -Sed
-  These programs are all on the OpenVMS freeware CD and can be downloaded from
+      get it from http://www.openvms.digital.com/freeware/
-  http://www.openvms.digital.com/freeware/
+
-  At the moment you'll have to hack the descrip.mms files to include the right
-  locations of the packages, but i intend to make this better in future.
     -sys$library:libjpeg.olb  (from ftp://ftp.uu.net/graphics/jpeg/ )
+        add /name=(as_is,short) to CFLAGS in the descrip.mms file
+        don't forget to mms/descrip=Makefile/macro="ALPHA=1"
+
     -sys$library:libpng.olb & sys$library:libz.olb (from
           http://www.cdrom.com/pub/png/pngcode.html )
+        add /name=(as_is,short) to CFLAGS in the descrip.mms of both png and
+        zlib
+
     -sys$library:libtiff.olb (from: ftp://ftp.sgi.com/graphics/tiff/ )
-
+       - add /name=(as_is,short) to the C_COMPILE variable in MAKVMS.COM
-Currently only the MOTIF GUI can be build by typing
+       - the following patch is needed in the tiff3.4 distribution:
-  MMS motif
- in the main directory of the distribution.
-
-The GTK GUI is now in Alpha testing. Type
-  MMS gtk
- in the main directory of the distribution to get a test. I builds the
-MINIMAL_GTK.exe sample only. It does something but I also got it crashing.
- 
- 
-It automatically makes the library in [.lib] and links some of the samples
-and utils.
-
-N.B.
- the following patch is needed in the tiff3.4 distribution:
-
 polka-jj) diff TIFFCOMP.H;3 TIFFCOMP.H;1
 ************
 File $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;3
@@ -59,14 +60,72 @@ File $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;1
   107   #include <unistd.h>
 ************
 
-Number of difference sections found: 2
+    -X11:libxpm.olb ( from ftp://koala.inria.fr/pub/xpm/ )
-Number of difference records found: 4
+        add /name=(as_is,short) to cc_defs in the descrip.mms file
 
-DIFFERENCES /IGNORE=()/MERGED=1-
+    -GTK & VMS Porting library (only needed for wxGTK)
-    $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;3-
+       ( from http://www.openvms.digital.com/openvms/products/ips/gtk.html )
-    $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;1
+
+    -Redefine the logical SYS$LIBRARY in such a way that it also points
+     to the includefile/library directories of the obove packages:
+     i.e.
+$ define sys$library sys$sysroot:[syslib],-
+     $disk2:[joukj.public.xpm.xpm.lib],-
+     $disk2:[joukj.public.jpeg.jpeg],-
+     $disk2:[joukj.public.png.libpng],-
+     $disk2:[joukj.public.tiff.tiff.libtiff],-
+     $disk2:[joukj.public.png.zlib],-
+     $disk2:[joukj.public.gtk.gtk.glib],-
+     $disk2:[joukj.public.gtk.gtk.glib.gthread],-
+     $disk2:[joukj.compaq.porting_library.dist.include]
+
+    -redefine the logical X11 in such a way that also points to the
+      xpm-distribution.
+      i.e.
+$  define/nolog X11 $disk2:[joukj.public.xpm.xpm.lib],decw$include
+
+    -for wxGTK you'll have to redefine SYS$SHARE to compile and run the
+         applications.
+     i.e.
+$  ass $disk2:[joukj.public.gtk.gtk.glib],-
+       $disk2:[joukj.public.gtk.gtk.glib.gmodule],-
+       $disk2:[joukj.public.gtk.gtk.gtk.gdk],-
+       $disk2:[joukj.public.gtk.gtk.gtk.gtk],-
+       $disk2:[joukj.compaq.porting_library.dist.lib],-
+       sys$sysroot:[syslib] sys$share
+
+    -At the moment you'll have to hack the [.src.common]descrip.mms file
+       to include the right location of bison/flex and sed, but i intend to
+       make this better in future.
+
+    -The following is a work-around a include file bug which occurs on some
+      versions of VMS. If you get lib$get_current_invo_context undefined
+      while linking you'll have to add
+         "lib$get_current_invo_context"="LIB$GET_CURR_INVO_CONTEXT"
+      in [.src.unix]descrip.mms to CXX_DEFINE. and recompile wxWindows.
+
+    -Some versions of the CC compiler give warnings like
+       %CC-W-CXXKEYWORD, "bool" is a keyword in C++ .... when compiling
+       if You encounter these, replace mms by mms/ignore=warning in the
+       following
+
+  -Now build evrything using one of the following
+      mms
+      mms gtk
+      mms motif
+    in the main directory of the distribution. Without an argument both wxGTK
+    and wxMOTIF are build. The libraies are build in the [.lib] directory.
+    All the samples I tried are build automatically.
+
+  -I think in general wxGTK is better maintained, so that version is my
+    first choice.
+  
+  -Note that only a few people have used wxWindows on VMS so many problems are
+   to be expected.
 
 
+ -Many thanks for testing and reporting problems to:
+    -Walter Braeu
 
 Finally :
  I like the idea of Robert Roebling that CD's with classical music should be