Added extra wxGLCanvas documentation from

[wxWidgets.git] / docs / readme_vms.txt

diff --git a/docs/readme_vms.txt b/docs/readme_vms.txt
index f8dc78f4f7dac18b4d1494cbb537e9493952941d..15468f3a919568edcadca3aed0eea2e313c0ff3b 100644 (file)
--- a/docs/readme_vms.txt
+++ b/docs/readme_vms.txt
@@ -6,37 +6,38 @@ The compilation was tested with
     -DECC 6.2
     -Compac C++ 6.2
     -DECWindows 1.2-5
     -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
     -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
     -Flex

+      get it from http://www.openvms.digital.com/freeware/
+

     -Sed
     -Sed

-  These programs are all on the OpenVMS freeware CD and can be downloaded from
-  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.
+      get it from http://www.openvms.digital.com/freeware/
+

     -sys$library:libjpeg.olb  (from ftp://ftp.uu.net/graphics/jpeg/ )
     -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 )
     -sys$library:libpng.olb & sys$library:libz.olb (from
           http://www.cdrom.com/pub/png/pngcode.html )

-    -sys$library:libtiff.olb (from: ftp://ftp.sgi.com/graphics/tiff/ )
-
-Currently only the MOTIF GUI can be build by typing
-  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:
+        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
+       - 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
 polka-jj) diff TIFFCOMP.H;3 TIFFCOMP.H;1
 ************
 File $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;3


@@ -59,15 +60,94 @@ File $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;1
   107   #include <unistd.h>
 ************
 
   107   #include <unistd.h>
 ************
 

-Number of difference sections found: 2
-Number of difference records found: 4
-
-DIFFERENCES /IGNORE=()/MERGED=1-
-    $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;3-
-    $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;1
-
-
-
+    -X11:libxpm.olb ( from ftp://koala.inria.fr/pub/xpm/ )
+        add /name=(as_is,short) to cc_defs in the descrip.mms file
+
+    -GTK & VMS Porting library (only needed for wxGTK)
+       ( from http://www.openvms.digital.com/openvms/products/ips/gtk.html )
+
+    -Redefine the logical SYS$LIBRARY in such a way that it also points
+     to the includefile/library directories of the above 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 everything 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 built. The libraries are built in the [.lib] directory.
+    All the samples I tried are built 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
+
+
+ -Known problems :
+   wxMOTIF :
+       -The calendar sample puts the boxes of the month and year selection on
+        top of each other.
+       -The caret sample: sometimes a non blinking caret remains in the
+        window.
+       -checklist sample: There is no way to check/uncheck since this box is
+        missing
+       -conftest sample: The boxes in the window are too small to display
+        texts with the fonts specified.
+       -controls sample: radiobox does not appear on the screen
+       -Some samples crash due to colour allocation problems
+        i.e. -drawing,image
+
+   wxGTK :
+       -In the calendar sample options can only be switched on and not off
+        again.
+       -image sample: after clicking "about" the colourmap is permanently
+        changed resulting in strange images
+     

 Finally :
  I like the idea of Robert Roebling that CD's with classical music should be
 send to the authors.
 Finally :
  I like the idea of Robert Roebling that CD's with classical music should be
 send to the authors.